Empezar
Theus es un agente de código que trabaja en tu terminal, en castellano y local-first. Cinco pasos: instalar, conectar tu cuenta, dar tu primera instrucción, volver mañana donde lo dejaste y — si quieres — sumar Ñaupa. El plan Free incluye 25 créditos + 19 cada día tus primeras 3 semanas, sin tarjeta y sin fecha de caducidad.
$ curl -fsSL https://theus.pe/install.sh | bash01Instalar
El instalador te descarga el programa ya compilado, no un paquete que necesite otro motor: no se descarga nada más. En macOS viene firmado y notarizado por Apple, y el instalador comprueba esa firma antes de dejarlo en tu equipo — si el archivo no es el que publicamos, se detiene. Está todo en la guía de instalación.
$ curl -fsSL https://theus.pe/install.sh | bash
02Conectar
theus y conecta con theus login.El CLI abre theus.pe en tu navegador, autorizas y la API key vuelve sola por callback local. No hace falta registrarse antes: el enlace que te llega al correo también crea tu cuenta, vive quince minutos y el CLI te espera ese mismo rato. A partir de ahí, una sola cuenta te da CLI, chat, consola y API. El catálogo de 190 modelos servibles es escalonado: el plan gratuito abre cuatro para que pruebes, y los modelos frontier empiezan en el primer plan de pago —el detalle, en precios.
$ theus $ theus login Abrí tu navegador para que autorices Theus. Te espero 15 minutos. (Ctrl+C cancela; no se cobra nada) ✓ Sesion Theus instalada para tu@correo.pe (plan free).
03Primera sesión
Entra a la carpeta de tu proyecto y ejecuta theus. Escribe una instrucción — corregir un error, explicar un módulo, escribir una función — y el agente lee tu código, propone ediciones que apruebas o rechazas y ejecuta comandos con tu confirmación. Tú mantienes el control en cada paso.
$ cd mi-proyecto && theus > Corrige el error del formulario de login y ejecuta las pruebas
04Volver
theus -c y sigues.Cada conversación queda guardada en la carpeta donde la tuviste. theus -c retoma la más reciente de ese proyecto con el contexto ya puesto, y theus -r abre el selector para que elijas cuál. Si quieres seguir una conversación sin escribir sobre la original, añade --fork-session. Y ya dentro de la sesión, /resume —o /continuar— hace lo mismo sin salir del CLI.
$ cd mi-proyecto && theus -c -> retoma la última conversación de esta carpeta $ theus -r -> abre el selector para elegir cuál
05ÑaupaOpcional
Ñaupa es el motor de inteligencia de código de Theus: gratuito con el índice en tu disco, escrito en C puro, analiza el AST de 158 lenguajes, construye un grafo de conocimiento de tu repositorio y expone 19 herramientas MCP desde un binario estático. Todo el índice vive en tu máquina. El instalador del paso 1 ya lo incluye, en los tres sistemas: este comando solo hace falta si lo omitiste o quieres reinstalarlo.
$ curl -fsSL https://theus.pe/naupa.sh | bash
Crea tu cuenta con el plan Free (25 créditos + 19 cada día tus primeras 3 semanas, sin tarjeta). Si te quedan dudas, la documentación cubre instalación, uso del CLI, modelos y cuotas; y en precios están los seis planes al detalle.