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.7.6
  • 5 platforms
  • The index on your disk
  • From USD 31
Install Theus CLI →See installers and their checksums ↗

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.

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

  2. One account for your models

    Sign in to Theus and use the catalogue included in your plan. Theus manages the connection and usage through the same account.

  3. 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 | bash

Windows, from PowerShell

$ powershell -c "irm https://theus.pe/install.ps1 | iex"

With npm, on any of the three

$ npm install -g theus-cli

If you are on Windows, read this before copying anything

In PowerShell, use the command shown for Windows. It uses Invoke-WebRequest to download the installer.

How is it different from the chat?

Criterion by criterion.

Theus CLI against Theus Chat, criterion by criterion
Where it runsTheus CLIIn your terminal, on the repository you already have open.Theus ChatIn the browser, installing nothing.
Which files it touchesTheus CLIYour project's, through the permission flow.Theus ChatThe session workspace's; it hands them back when it finishes.
Where execution happensTheus CLIOn your machine, with your dependencies and your versions.Theus ChatIn a hardened container, no network and read-only.
What it remembersTheus 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 otherTheus CLIIt receives the chat's conversation through the teleport command.Theus ChatEvery conversation carries its teleport command in the top bar.
When to pick itTheus 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.

  1. Do I need a Theus account?

    Downloading and installing are free. To use models, sign in to your Theus account; your plan's catalogue and limits apply.

  2. Can I use my own key or a local model?

    Starting with version 1.7.2, the CLI works exclusively with Theus. External keys, other gateways and local models are not CLI connection options.

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

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

  5. Can I pick up yesterday's conversation?

    Yes, with nothing to do: every conversation is recorded in the folder where you had it.

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

Install Theus CLI →See the plans →