Theus documentation

Theus is a local-first, multimodel coding agent that runs from your terminal — with its own local router, code memory and project graph. Made in Peru.

What Theus is

Theus opens an interactive session inside any project, indexes your code locally to cut repeated context, and brings up a local dashboard that explains the project instead of just drawing dots. It is built so that every user connects their own local model or their own API key — no external brand and no single mandatory provider.

Local-first by default. The index, memory and graph live under ~/.theus/knowledge/ on your machine.
Multimodel router. Point Theus at a local engine or any OpenAI-compatible endpoint through THEUS_* variables or ~/.theus/providers.json.
Memory and graph. Theus extracts symbols, builds nodes and relationships, and detects SQL/Prisma schemas as a real visual layer.
Local API + dashboard. A service on 127.0.0.1 exposes project status, graph and database schema.

All product copy is Spanish-first. This English section mirrors the core reference for readers who prefer English; the CLI interface itself remains Spanish-first with short English labels where it helps.

Install

Theus runs on Bun. The official installer downloads Bun for you if it is missing (verifying its SHA-256 checksum).

curl -fsSL https://theus.pe/install.sh | bash
theus --version

The installer detects your platform (macOS/Linux, x64/arm64), verifies the release checksum, installs into ~/.theus/app and links the theus command on your PATH. Re-run it any time to update — it is idempotent.

First run

cd /path/to/your/project
theus

On start, Theus indexes the project, brings up the local API and opens the dashboard. To connect a model without logging in, export a compatible endpoint:

export THEUS_BASE_URL="http://127.0.0.1:11434/v1"
export THEUS_MODEL="llama3.1"
export THEUS_API_KEY="local"
theus

English pages

Page	What it covers
CLI reference	Commands, flags and the `theus` launcher.
Keybindings	Shortcuts inside the interactive REPL.
Fast mode	Running Theus non-interactively and lightweight flows.
Memory	The local index, code memory and graph under `~/.theus/knowledge/`.
MCP servers	Connecting Model Context Protocol servers.
Network configuration	Local API ports and connectivity settings.
Remote control	Driving Theus beyond the local terminal.
Theus on the web	The web console and how it relates to the CLI.
Documentation map	Full index of the English documentation.
API · files content	Local file-content API endpoint.

Connect a Theus account

To use the hosted router served by theus.pe, sign in from the CLI:

theus login

This opens the OAuth flow on https://theus.pe, exchanges the code for a token and installs the official theus-official provider in ~/.theus/providers.json, so you can just run theus and send prompts. Any hosted or marketplace service is opt-in; a remote service is never required to start the CLI.

Made in Peru — Theus, hecho en Perú. Ad astra per aspera.

Theus — local-first multimodel coding agent · Made in Peru