Tegoby Attention SpanBlogBook a demo

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

Terminal
curl -fsSL https://github.com/Attention-Span-AI/Tego/releases/latest/download/install.sh | sh

It 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.

Terminal on your Mac
brew install lima
limactl start --name=tego https://github.com/Attention-Span-AI/Tego/releases/latest/download/tego.yaml
limactl shell tego tego doctor

Lima 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:

Terminal on your Mac
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.

PowerShell as administrator
wsl --install -d Ubuntu-24.04

This 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:

In Ubuntu
curl -fsSL https://github.com/Attention-Span-AI/Tego/releases/latest/download/install.sh | sh

Install 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):

Shell
tego doctor

It checks the kernel line by line, then names the protection level this machine gives, for example:

Output
tier: landlock

Any 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 the export line the installer printed, or open a new terminal.

  • The cgroup check fails. Your shell started outside your user's session, as SSH and limactl shell do. Start one inside it, then run tego doctor again and start every run from that shell:

    Shell
    systemd-run --user --scope bash
  • In WSL2, systemd is not running. ps -p 1 -o comm= should print systemd. If it doesn't, add [boot] and systemd=true to /etc/wsl.conf, then run wsl --shutdown in 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:

Terminal
curl -fsSL https://github.com/Attention-Span-AI/Tego/releases/latest/download/install.sh | TEGO_VERSION=v0.1.3 sh

Uninstall

Shell
rm ~/.local/bin/tego ~/.local/bin/tego-control

Tego 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:

On your Mac
limactl stop tego
limactl delete tego

Build from source

You need git, make and Go 1.27, on Linux or inside the VM. On Debian or Ubuntu:

Shell
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:

Shell
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 version

Use 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.