Install Tego
Updated
Install Tego with one command on Linux, or inside a small Linux VM on a Mac or Windows PC, then check it with tego doctor.
On this page
curl -fsSL https://github.com/Attention-Span-AI/Tego/releases/latest/download/install.sh | shIt installs tego and tego-control in ~/.local/bin, with no root, after checking each against the release's published SHA-256. If that folder is not on your PATH, it prints the export line to add.
brew install lima
limactl start --name=tego https://github.com/Attention-Span-AI/Tego/releases/latest/download/tego.yaml
limactl shell tego tego doctorLima runs Linux VMs on a Mac. These lines start an Ubuntu 24.04 VM named tego with Tego inside, and check it. If Lima asks how to go on, choose Proceed with the current configuration. You need Lima 2.0 or later and macOS 13.5 or later. The template has booted on an Apple silicon Mac with Lima 2.3, but the Mac path is not fully tested yet. Why a VM, and what it isolates: Run Tego on a Mac or Windows PC.
Tego only governs what runs inside the VM, so install and run your agent there too. An agent started on the macOS side is not under Tego's rules.
As written, the VM can read your whole Mac home, including ~/.ssh. To share nothing from your Mac, start the VM this way instead and keep your projects inside it:
limactl start --name=tego --mount-none https://github.com/Attention-Span-AI/Tego/releases/latest/download/tego.yaml On a Mac, keep the project inside Tego's VM; a folder shared from the Mac can't be used. To open the dashboard from your Mac, see Dashboard.
wsl --install -d Ubuntu-24.04This installs WSL2, a real Linux kernel on Windows, with Ubuntu 24.04. These steps have not been run on Windows yet. Restart Windows if it asks, open Ubuntu from the Start menu and create your Linux user. Then, in Ubuntu:
curl -fsSL https://github.com/Attention-Span-AI/Tego/releases/latest/download/install.sh | shInstall and run your agent inside Ubuntu, and keep your projects in your Linux home (~), not under /mnt/c. WSL also lets the agent read your Windows drives and start Windows programs, which Tego can't govern. To close both, set enabled=false under [automount] and under [interop] in /etc/wsl.conf, or give your rules an exec: allow list and add your Windows secret folders to deny_read. More in Security and limits.
Requirements
Linux on amd64 or arm64, kernel 5.19 or later (or RHEL 9's 5.14), with cgroup v2. Any Linux 6.1 or later from a desktop login works, Ubuntu 24.04 included. Ubuntu 22.04's stock 5.15 kernel is not supported. On a Mac or Windows PC, the VM above meets these.
Check it
In the same terminal (on a Mac, inside the VM: limactl shell tego):
tego doctorIt checks the kernel line by line, then names the protection level this machine gives, for example:
tier: landlockAny tier other than none means Tego can enforce your rules: landlock is the Basic level, with no root. A fix: line under it says what to change for a higher level; Protection levels explains each one.
If something fails:
tego: command not found. Run theexportline the installer printed, or open a new terminal.The cgroup check fails. Your shell started outside your user's session, as SSH and
limactl shelldo. Start one inside it, then runtego doctoragain and start every run from that shell:Shell systemd-run --user --scope bashIn WSL2, systemd is not running.
ps -p 1 -o comm=should printsystemd. If it doesn't, add[boot]andsystemd=trueto/etc/wsl.conf, then runwsl --shutdownin PowerShell and open Ubuntu again.
Next: the Quickstart.
Update
Run the install command again. It installs the latest release and replaces both binaries together. The contract format may still change before v0.2.0, so read the changelog when you update.
To install a specific release, set TEGO_VERSION:
curl -fsSL https://github.com/Attention-Span-AI/Tego/releases/latest/download/install.sh | TEGO_VERSION=v0.1.3 shUninstall
rm ~/.local/bin/tego ~/.local/bin/tego-controlTego keeps its records and config in ~/.tego. Remove that folder only if you no longer need the records.
On a Mac, deleting the VM removes Tego, its records and anything you kept inside the VM:
limactl stop tego
limactl delete tegoBuild from source
You need git, make and Go 1.27, on Linux or inside the VM. On Debian or Ubuntu:
sudo apt update
sudo apt install -y git make curl
arch=$(uname -m); case "$arch" in x86_64) arch=amd64 ;; aarch64) arch=arm64 ;; esac
curl -fsSLO "https://go.dev/dl/go1.27.3.linux-$arch.tar.gz"
sudo rm -rf /usr/local/go && sudo tar -C /usr/local -xzf "go1.27.3.linux-$arch.tar.gz"
export PATH="/usr/local/go/bin:$PATH"On Fedora or RHEL, use sudo dnf install -y git make in place of the two apt lines. Then build and install both binaries:
git clone https://github.com/Attention-Span-AI/Tego
cd Tego
make build
mkdir -p ~/.local/bin
install -m 0755 bin/tego bin/tego-control ~/.local/bin/
tego versionUse make build, not go build: it pins tego-control into tego, and the dashboard needs that pair. Keep the two binaries in the same folder, and rebuild both together. To update, run git pull, make build and the install line again.