The agent that livesin your terminal.
You ask for something in your own language and it works on the files you already have open: it reads, writes, runs tests and shows you every change before touching anything.
- v1.5.0
- 5 platforms
- The index on your disk
- From USD 29
$ curl -fsSL https://theus.pe/install.sh | bash$ theus --version1.5.0 (Theus)# The macOS binary is signed and notarised by Apple:$ spctl -a -vv -t install ~/.theus/app/theusacceptedsource=Notarized Developer ID
El problema, en una frase
«I ask the agent for something and it answers as if it were the first time it had seen my code: I have to explain everything all over again.»
Theus CLI indexes your project on your machine — and does not forget it
What does Theus CLI do?
It reads, it fixes and it checks.
The index lives on your disk
Symbols, graph and memory are built on your machine, under ~/.theus/knowledge/. None of it is thrown away when you close the terminal: every conversation is saved in its folder.
It does not tie you to any service
Point it at your own key, at your gateway or at a local model on your machine. It is a design decision, not a hidden mode.
You top up from the terminal
The /recarga command lists the credit packs and the binary carries the payment route inside, without opening a browser.
What is inside?
An arsenal that shipsinside the same binary.
- 1 229Slash entries in a clean session
- 30Agent tools by default
- 1 062Skills + 64 packaged agents
- 5Compiled platforms
What is not inside: Ñaupa
Ñaupa does not travel in the CLI binary: it is a separate, free engine installed with its own line. theus update updates both.
How is it installed?
With one line.
macOS and Linux
$ curl -fsSL https://theus.pe/install.sh | bashWindows, from PowerShell
$ powershell -c "irm https://theus.pe/install.ps1 | iex"With npm, on any of the three
$ npm install -g theus-cliIf you are on Windows, read this before copying anything
1. In PowerShell, curl is not curl: it is another name for Invoke-WebRequest. That is why the Windows command is a different command entirely, not a translation of the macOS one.
2. The Windows artefact is published unsigned: the system will show a security warning when you run it. The macOS binaries are signed and notarised by Apple.
How is it different from the chat?
Criterion by criterion.
| Criterion | Theus CLI | Theus Chat |
|---|---|---|
| Where it runs | Theus CLIIn your terminal, on the repository you already have open. | Theus ChatIn the browser, installing nothing. |
| Which files it touches | Theus CLIYour project's, through the permission flow. | Theus ChatThe session workspace's; it hands them back when it finishes. |
| Where execution happens | Theus CLIOn your machine, with your dependencies and your versions. | Theus ChatIn a hardened container, no network and read-only. |
| What it remembers | Theus CLIThe index and the graph on your disk, and each folder's conversation. | Theus ChatPer-project instructions and facts between conversations. |
| Moving from one to the other | Theus CLIIt receives the chat's conversation through the teleport command. | Theus ChatEvery conversation carries its teleport command in the top bar. |
| When to pick it | Theus CLIWork on a real repository, with the result in your files. | Theus ChatStarting in thirty seconds, or on a machine that is not yours. |
If in doubt, start in the chat and carry on in the CLI: the jump exists for exactly that.
Frequently asked about Theus CLI
The limits, stated beforeyou run into them.
Do I need a Theus account?
To install it and use it with your own key or your own model, no. The account is needed to use the catalogue included in the plans.
Can I use my own key or a local model?
Yes, and it is a design decision, not a hidden mode: point it at your key, at your gateway or at a local model.
Does my code leave my machine?
The index, the graph and the memory are built and stay in ~/.theus/knowledge/. When a cloud route is used, only the session's context travels.
Which languages does it understand?
The built-in index reads JavaScript and TypeScript (.ts, .tsx, .js, .jsx, .mjs, .cjs). Every other language is covered by Ñaupa, with AST for 158 languages.
Can I pick up yesterday's conversation?
Yes, with nothing to do: every conversation is recorded in the folder where you had it.
How do I update it?
With theus update from the terminal itself. That same command also updates Ñaupa if you have it installed.
One line in your terminaland you are in.
$ curl -fsSL https://theus.pe/install.sh | bash