Tego FAQ
Updated
Short answers to what people ask first. Each one links to the page with the details.
On this page
What is Tego?
Tego runs your AI agent under rules enforced from outside it: you write which files, network hosts and programs the agent may use, and the Linux kernel and Tego's supervisor enforce them. It can hold an action until you approve it, and it keeps a tamper-evident record of each run. Try it with the quickstart.
Who makes Tego?
Attention Span. The code is open source on GitHub, and About Attention Span says how to reach us.
Is Tego a sandbox?
Not one that hides the machine. The agent works in your real project and can read any path you have not denied, while a built-in list keeps secret files out of reach and Tego refuses whatever your rules rule out. Security and limits says exactly where the line is.
Does Tego need root?
No. The Basic protection level needs no root on Linux 5.19 or later, and root through sudo only adds the Plus and Max levels. Protection levels shows which one your machine gets.
Does Tego run on macOS or Windows?
Through a small Linux VM. On a Mac you run Tego and the agent inside a Lima VM, and on Windows inside WSL2. On a Mac, keep the project inside Tego's VM; a folder shared from the Mac can't be used. Tego's Mac VM has booted on an Apple silicon Mac, but the Mac path is not fully tested yet, and the Windows path has not been run on a real PC. Install has the commands for each.
Which AI agents work with Tego?
Any agent that runs as an ordinary Linux process. The repository has ready rules for Claude Code, OpenAI Codex, the Claude Agent SDK, the Anthropic Python SDK and an agent of your own. See Run your agent.
Do I need to change my agent or my code?
No code changes. Claude Code signs in outside Tego with a token, and Codex runs with its own sandbox off; the example contracts set this up. Run your agent has the details.
What happens when the agent breaks a rule?
The action fails with an ordinary "permission denied" error, and the refusal is recorded with the rule that refused it (at Basic, refused reads only under record: full). The agent can read why and carry on with its work, or you can set a rule to hold the action until you approve it in the dashboard.
Can Tego keep an agent away from my SSH keys and .env files?
Yes. Every contract denies reads of SSH keys, cloud credentials, token stores and .env files, and the tego/no-secrets preset also keeps secret environment variables away from the agent. Write rules shows how to add your own paths, and Security and limits lists the gaps.
Can Tego stop data leaving my machine?
Partly. Tego refuses hosts your rules do not name, but every host you do allow stays a way out for anything the agent can read. Security and limits explains how to narrow that.
Does Tego send my code or data anywhere?
No. Tego has no telemetry, no update check and no crash reports, and each run's record stays on your machine. What Tego keeps and sends lists its only network traffic.
Does Tego use an AI model to decide?
No. Tego never calls a model; your rules decide, and the kernel and Tego's supervisor enforce them. Security and limits explains how.
Can the agent change the record?
Not an agent held by your rules: each line carries the hash of the one before it, so an edit shows. The person who started the run can change it, and so can an agent in a watch-only run, as Security and limits explains.
Can Claude Code or Codex keep their own sandbox on inside Tego?
No. Both use bubblewrap on Linux, which cannot start inside a Tego run, so their example contracts turn it off and Tego holds the agent instead. See Run your agent.
How is Tego different from Docker or a dev container?
A container separates a whole environment from your machine. Tego governs the agent's own processes in your real project and keeps a record of what it did, and the two can be combined. Ways to sandbox AI agents compares them.
Will Tego slow my agent down?
Tego never calls a model, so its checks cost no tokens. Its time cost has not been measured on a current release yet. The settings that slow each file open, such as recording every read (record: full), are off by default; Write rules covers them.
Does Tego work in CI?
Yes, with a step you write yourself. tego run works on a hosted runner at the Basic level, with no root, and at Plus through sudo on GitHub's ubuntu-24.04 runner. Tego has no ready-made CI setup: you add tego run to your workflow and write its contract. Protection levels has the details.
Is Tego free, and under which license?
Yes. Tego is open source under Apache-2.0, with its kernel programs dual licensed GPL-2.0-only or BSD-2-Clause. See Security and limits.
How do I report a security problem?
Privately, through GitHub's Report a vulnerability form on the Tego repository, never in a public issue. Report a vulnerability says what to include.
Claude, Codex and other product names are trademarks of their owners; Tego is not affiliated with or endorsed by them.