Documentación de Theus

Theus es un agente de código local-first y multimodelo, hecho en Perú: abre una sesión interactiva desde cualquier proyecto, lo indexa en tu propia máquina, mantiene memoria y un grafo del código, y ejecuta tareas de programación con el modelo que elijas. Con la suscripción Theus accedes a los mejores modelos frontier de código y razonamiento a través de un gateway gestionado — sin traer tus propias API keys.

Una suscripción, un catálogo verificado, un cerebro. Theus configura de forma central las API keys de cada proveedor upstream; tú usas una sola API key de Theus. TITAN, el orquestador propio, analiza cada petición, decide si la resuelve con un modelo o la descompone entre varios, y sintetiza la respuesta final — o fijas el modelo que quieras con /model. Ver Planes y suscripción y TITAN.

Qué es Theus

Theus se usa de dos maneras, y las dos son ciudadanas de primera clase:

Local-first / BYOK — apunta el CLI a cualquier endpoint OpenAI-compatible (un modelo local en tu máquina, un gateway propio, tu propia key). Todo corre localmente; ningún servicio remoto es obligatorio para arrancar.
Suscripción Theus (gateway gestionado) — theus login conecta el CLI al gateway de theus.pe. Con una sola API key de Theus accedes al catálogo completo de modelos; el modelo por defecto es titan.

Al arrancar dentro de un repositorio, Theus:

Indexa el proyecto localmente: archivos, símbolos, grafo del código y esquemas SQL/Prisma.
Levanta una API local en 127.0.0.1 con estado, grafo y esquema de base de datos, y abre un dashboard visual.
Mantiene memoria persistente del proyecto en ~/.theus/knowledge/.
Monta Ñaupa como servidor MCP si el binario está instalado (grafo de conocimiento AST, consultas en <1 ms).

Toda la configuración vive bajo ~/.theus/ y las variables de entorno usan el prefijo THEUS_*.

Empieza en 3 pasos

# 1. Instala el CLI (instala Bun por ti si falta, con verificación SHA-256)
curl -fsSL https://theus.pe/install.sh | bash
#    En Windows (PowerShell): powershell -c "irm https://theus.pe/install.ps1 | iex"

# 2. Conecta tu suscripción (abre el navegador; OAuth con PKCE contra theus.pe)
theus login

# 3. Abre una sesión en tu proyecto
cd /ruta/de/tu/proyecto
theus

Para una ejecución no interactiva usa theus -p "tu prompt". Dentro de la sesión, /help muestra la ayuda y /model cambia de modelo. El detalle completo está en Instalación.

Entrada a la misión. En el menú inicial selecciona «Iniciar misión». Theus confirma la acción con un wordmark ASCII breve y luego entrega el chat. La transición puede saltarse con cualquier tecla, se compacta en terminales angostas y respeta reduced motion, NO_COLOR y el modo ASCII. El texto funcional usa el color neutral de tu terminal para conservar contraste sobre fondos claros y oscuros.

¿Prefieres no usar cuenta? Theus arranca igual: exporta THEUS_BASE_URL, THEUS_MODEL y THEUS_API_KEY hacia cualquier endpoint OpenAI-compatible, o define proveedores en ~/.theus/providers.json. Ver Configuración de modelos.

Mapa de la documentación

Empezar

Página	Qué cubre
Instalación	Métodos de instalación (instalador oficial, npm), primer arranque, `theus login`, actualización y desinstalación.
Planes y suscripción	Los planes con precios, qué incluye la suscripción, cómo funciona el gateway gestionado, créditos y la consola de cuenta.

Plataforma

Página	Qué cubre
TITAN	El orquestador propio de Theus: planificación, ejecución multi-modelo y síntesis.
Modelos	Selección de modelo con `/model`, variables `THEUS_*` y `providers.json`.
Costos y consumo	El comando `/cost`, cómo se calcula el consumo y cómo controlar el gasto.
API /v1	El gateway OpenAI-compatible: `/v1/models`, `/v1/chat/completions` y autenticación con tu API key de Theus.

Funciones

Página	Qué cubre
Memoria	Memoria persistente del proyecto: índice local, recall semántico y qué se guarda en `~/.theus/knowledge/`.
Ñaupa	El motor de inteligencia de código: grafo de conocimiento AST, 158 lenguajes, consultas Cypher, 19 herramientas MCP.
Computer-use	Control de escritorio en macOS: captura de pantalla, mouse y teclado (opt-in).
Servidores MCP	Cómo ampliar las capacidades del agente con servidores MCP.
Theus como MCP	Usar Theus desde otros agentes vía MCP.
Hooks	Ganchos para automatizar comportamiento alrededor de la sesión.
Sandboxing	Aislamiento de ejecución y control de lo que el agente puede tocar.
Modos autónomos (beta)	Modos beta opt-in, apagados por defecto: el modo proactivo (`THEUS_PROACTIVE=1`) y el modo asistente (`THEUS_KAIROS=1`, que además requiere suscripción y sesiones de código remotas cuya infraestructura está en desarrollo). No son funciones GA.

Referencia

Página	Qué cubre
Seguridad	Permisos de herramientas, límites y buenas prácticas.
Novedades	Cambios y versiones del producto.

Comandos principales

Comando	Propósito
`theus`	Inicia la sesión interactiva en el proyecto actual.
`theus -p "prompt"`	Ejecuta en modo no interactivo.
`theus login`	Conecta tu suscripción Theus (OAuth con PKCE contra `theus.pe`).
`theus --help`	Muestra la ayuda del CLI.
`/help`	Ayuda dentro de la sesión.
`/model`	Selección de modelo.
`/cost`	Costo y consumo de la sesión.
`/mcp`	Servidores MCP conectados.
`/permissions`	Permisos de herramientas.

La lista completa está en la Referencia de comandos.

El copy visible de Theus se mantiene en español primero y sin marcas externas. La única excepción es el catálogo de modelos, donde sí aparecen los nombres reales de los modelos incluidos en la suscripción.

Theus — Muchas inteligencias. Una decisión.