Theus CLI: el agente de programación que vive en tu terminal, con su ayuda y su arsenal en castellano
Le pides algo en tu propio idioma y trabaja sobre los archivos que ya tienes abiertos: lee, escribe, edita y corre comandos, sin que le expliques dónde está cada cosa, porque indexa el repositorio en tu propia máquina. Se instala con una línea, funciona con tu clave o con un modelo tuyo, y se paga en soles.
Versión 1.2.15 plataformasEl índice se queda en tu discoDesde S/ 39 al mes, con plan gratuito para probar
$ curl -fsSL https://theus.pe/install.sh | bash $ theus --version 1.2.1 (Theus) # El binario de macOS va firmado y notarizado por Apple: $ spctl -a -vv -t install ~/.theus/app/theus accepted source=Notarized Developer ID
¿Para quién es Theus CLI?
Desarrolladores que trabajan en terminal sobre un repositorio de verdad y quieren un agente que ya venga configurado, sin traer veinte claves ni pagar en dólares.
El problema, tal cual lo cuentan
«Le pido algo al agente y me contesta como si fuera la primera vez que ve mi código: le tengo que explicar dónde está cada cosa, y aun así toca archivos que no debía.»
¿Qué hace Theus CLI?
El índice vive en tu disco
Símbolos, grafo y memoria se construyen en tu máquina, en ~/.theus/knowledge/, y el panel que los enseña escucha solo en 127.0.0.1 detrás de un token de sesión.
No te ata a ningún servicio
Apúntalo a tu propia clave, a tu gateway o a un modelo local de tu máquina. Si no configuras nada, degrada a un motor de compatibilidad en lugar de morir.
Se paga en soles desde la terminal
El comando de recarga lista los packs en soles y el binario publicado trae la ruta de pago con Yape, sin abrir el navegador.
¿Cómo se instala Theus CLI?
Con una línea, y en macOS y Linux es la misma. En Windows cambia el comando entero porque cambia el intérprete: ahí va por PowerShell, y con un detalle que hace fallar a mucha gente y que está en el aviso de aquí abajo.
macOS y Linux
curl -fsSL https://theus.pe/install.sh | bashComando de instalación de Theus CLI en macOS y Linux.
Windows, desde PowerShell
powershell -c "irm https://theus.pe/install.ps1 | iex"Comando de instalación de Theus CLI en Windows.
Con npm, en cualquiera de los tres
npm install -g theus-cliComando de instalación de Theus CLI en cualquiera de los tres sistemas, con npm.
Cuando termine, theus --version te dice qué quedó instalado. En el Mac donde medimos esta versión responde 1.2.1 (Theus) —lo tienes arriba, en la terminal de la cabecera—. En Windows no lo hemos comprobado nosotros, y por eso está dicho abajo en lugar de enseñarte una salida que nadie ejecutó.
Si estás en Windows, lee esto antes de copiar nada
En PowerShell, curl no es curl: es otro nombre para Invoke-WebRequest, que acepta otros parámetros y devuelve otra cosa. Y bash no existe ahí. Así que cualquier receta del tipo curl … | bash que copies de un tutorial te va a fallar con un error que no dice por qué: en Windows el comando bueno es el de arriba, el de irm … | iex.
Segundo aviso, del mismo tamaño, y va entero: el artefacto de Windows se publica sin firmar y sin haber pasado nuestra prueba de humo nativa. Lo declara su propio fichero de release, y significa dos cosas — que el sistema te va a advertir antes de dejarte continuar y tendrás que confirmar tú, y que nadie de aquí ha arrancado ese binario en un Windows de verdad. Si algo te falla, escríbenos a contacto@theus.pe y lo arreglamos con tu caso delante. En macOS no pasa: ese binario va firmado, notarizado y comprobado.
¿Qué trae Theus CLI por dentro?
Un agente con sus herramientas y un arsenal en castellano, todo dentro del mismo binario compilado, más el índice que construye en tu disco en cuanto abres un proyecto. Esto es lo que hay, contado pieza por pieza sobre la versión 1.2.1 publicada:
- 410 entradas de barra en una sesión limpia: 90 comandos propios, 77 del arsenal y 243 destrezas invocables.
- 30 herramientas de agente activas por defecto: leer, escribir, editar, buscar, correr comandos, consultar la web y lanzar subagentes.
- Un arsenal escrito en castellano y empaquetado dentro del binario: 243 destrezas, 64 agentes y 77 comandos, que se instalan solos al arrancar.
- 5 plataformas compiladas: macOS arm64 y x64, Linux x64 y arm64, y Windows x64.
- El índice, el grafo y la memoria del proyecto se escriben en ~/.theus/knowledge/, en tu disco, y el panel que los enseña escucha solo en 127.0.0.1 detrás de un token de sesión.
Y nada de eso se tira al cerrar la terminal: cada conversación queda guardada en la carpeta donde la tuviste. Al día siguiente 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; con --fork-session la sigues en una sesión nueva sin escribir sobre la original. Dentro del CLI, /resume —también /continuar— hace lo mismo sin salir de la sesión.
Lo que no viene dentro: Ñaupa
Ñaupa no viaja en el binario del CLI: es un motor aparte, gratuito, que se instala con su propia línea. En cuanto lo tienes, el CLI lo monta solo como servidor de herramientas y suma 19 más, de las cuales 16 son de solo lectura y vienen pre-permitidas. Y es Ñaupa, no el CLI, quien lee 158 lenguajes: el índice que el CLI trae de fábrica solo lee JavaScript y TypeScript. Cómo funciona el motor está en la página de Ñaupa.
¿En qué se diferencia del chat de Theus?
El CLI trabaja sobre los archivos de tu máquina; el chat, sobre un espacio de trabajo aislado que corre en el navegador. Comparten la cuenta, los modelos y la factura, y una sesión de agente del chat salta a tu terminal con un comando —de modo que no es una elección de por vida, sino de esta tarde.
| Criterio | Theus CLI | Theus Chat |
|---|---|---|
| Dónde corre | En tu terminal, sobre el repositorio que ya tienes abierto. | En el navegador, sin instalar nada. |
| Qué archivos toca | Los de tu proyecto. Las herramientas que escriben pasan por el flujo de permisos antes de tocar nada. | Los del espacio de trabajo de la sesión, que te los devuelve al terminar. |
| Dónde se ejecuta el código | En tu máquina, con tus dependencias y tus versiones. | En un contenedor endurecido, sin red y con el sistema de archivos de solo lectura. Los topes exactos están en la página del chat. |
| Qué recuerda | El índice y el grafo del repositorio, construidos en tu disco, y la conversación de cada carpeta: theus -c la retoma donde la dejaste. | Instrucciones y archivos por proyecto, y hechos que guarda entre conversaciones. |
| Pasar de uno al otro | Recibe la conversación del chat con el comando de teletransporte. | Al cerrar una sesión de agente te da ese comando. Funciona también al revés. |
| Cuándo elegirlo | Cuando el trabajo es sobre un repositorio de verdad y quieres el resultado en tus archivos. | Cuando quieres empezar en treinta segundos o estás en una máquina que no es la tuya. |
Si dudas, empieza por el chat y sigue en el CLI: el salto está hecho justamente para eso. Y si lo que quieres es el precio, los planes en soles están en su propia página.
¿Qué no hace Theus CLI todavía?
Los límites, dichos antes de que los descubras
El índice que trae de fábrica lee JavaScript y TypeScript. El resto de lenguajes los cubre Ñaupa, que es un binario aparte y gratuito. Y el artefacto de Windows sale sin firmar y sin pasar nuestra prueba de humo nativa: el sistema te va a avisar, y ese binario no lo hemos arrancado nosotros en un Windows.
Preguntas frecuentes sobre Theus CLI
¿Qué es Theus CLI?+
Es un agente de programación que se ejecuta dentro de tu terminal: le pides algo en castellano y él lee, escribe y edita los archivos de tu proyecto, corre comandos y te enseña qué cambió. Antes de tocar nada indexa el repositorio en tu propia máquina, así que no le tienes que explicar dónde está cada cosa. La versión publicada es la 1.2.1 y hay binario para macOS, Linux y Windows.
¿Funciona en Windows?+
Hay binario nativo para Windows x64 y se instala desde PowerShell con una línea. Tres avisos por delante, y el tercero es el que casi nadie cuenta: los comandos del tipo curl … | bash que ves en los tutoriales no funcionan en PowerShell; el artefacto de Windows se publica sin firmar, así que el sistema te va a mostrar una advertencia antes de dejarte continuar; y ese mismo artefacto sale sin haber pasado nuestra prueba de humo nativa, es decir, nadie de aquí lo ha arrancado en un Windows de verdad. El binario de macOS sí va firmado, notarizado y comprobado. Si algo te falla en Windows, escríbenos a contacto@theus.pe.
¿Necesito una cuenta de Theus?+
Para instalarlo y usarlo con tu propia clave o con un modelo tuyo, no. La cuenta hace falta si quieres usar los modelos que incluye la suscripción y pagar en soles desde la terminal. Si no configuras nada, el CLI degrada a un motor de compatibilidad en lugar de morir en el arranque.
¿Puedo usar mi propia clave o un modelo local?+
Sí, y es una decisión de diseño, no un modo escondido: apúntalo a tu clave, a tu propia pasarela o a un modelo que corra en tu máquina, siempre que hable el protocolo compatible. Ningún servicio remoto es obligatorio para que el CLI arranque.
¿Mi código sale de mi máquina?+
El índice, el grafo y la memoria del proyecto se construyen y se quedan en ~/.theus/knowledge/, en tu disco, y el panel que los muestra escucha solo en 127.0.0.1 detrás de un token de sesión. Lo que sí viaja es lo que el modelo necesita para responderte: si el modelo es remoto, ese fragmento va a su proveedor; si el modelo corre en tu máquina, no sale nada. Y conviene decirlo entero: sin conexión no se comporta igual, porque el arranque consulta el tablón de avisos y el modo suscripción necesita el servidor.
¿Cuánto cuesta?+
Hay un plan gratuito para probarlo y la escalera de pago en soles empieza en S/ 39 al mes, con IGV incluido y sin tarjeta internacional. Además puedes comprar paquetes de recarga en soles sin salir de la terminal con el comando /recarga. Lo que incluye cada escalón está en la página de precios.
¿Qué lenguajes entiende?+
El índice que trae de fábrica lee JavaScript y TypeScript: .ts, .tsx, .js, .jsx, .mjs y .cjs. El resto de lenguajes los cubre Ñaupa —158 en total—, que es un binario aparte, gratuito, y que el CLI monta solo en cuanto lo tienes instalado.
¿Puedo retomar una conversación de ayer?+
Sí, y no hay que hacer nada para guardarla: cada conversación queda registrada 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 añades --fork-session la sigues en una sesión nueva, sin escribir sobre la original. Y ya dentro del CLI, el comando /resume —también /continuar o /reanudar— hace lo mismo sin salir.
¿Cómo lo actualizo?+
Con theus update desde la propia terminal. Ese mismo comando actualiza también Ñaupa si lo tienes instalado, así que el motor y el agente no se te quedan desparejados.
¿En qué se diferencia del chat de Theus?+
En dónde corre y sobre qué archivos trabaja. La comparación criterio por criterio está en la tabla de esta misma página, en la sección «¿En qué se diferencia del chat de Theus?».