Theus — agente de código para la terminal

Theus es un agente de programación que vive en tu terminal. Abres una sesión dentro de un proyecto y le hablas en español: lee el código, propone los cambios, edita los archivos y ejecuta comandos —siempre pidiéndote permiso antes de tocar o correr algo.

Funciona en macOS, Linux y Windows. Hecho en Perú.

• Web: https://theus.pe
• Documentación: https://docs.theus.pe
• Estado del servicio: https://theus.pe/estado

Instalación

npm install -g theus-cli
theus --version

Con Node 18 o superior basta. El producto viaja como binario nativo dentro de un paquete de plataforma (theus-cli-darwin-arm64, theus-cli-linux-x64, …) que npm instala como dependencia opcional: no instales con --omit=optional ni --no-optional, te quedarías con el lanzador y sin binario.

Plataformas publicadas: macOS (arm64 y x64), Linux (x64 y arm64) y Windows (x64).

Primer uso

cd /ruta/de/tu/proyecto
theus                    # sesión interactiva
theus -p "arregla el test que falla en checkout"   # una tarea, sin sesión
theus login              # conectar tu suscripción
theus update             # actualizar

Volver donde lo dejaste

Cada conversación queda guardada en la carpeta donde la tuviste, así que retomar el trabajo de ayer cuesta una tecla:

theus -c                 # retoma la conversación más reciente de esta carpeta
theus -r                 # abre el selector y eliges cuál retomar
theus -r <id-de-sesión>  # retoma una concreta por su ID
theus -c --fork-session  # la retoma en una sesión nueva, sin escribir sobre la original

Ya dentro de una sesión, /resume —también /continuar o /reanudar— hace lo mismo sin salir del CLI.

Qué hace de verdad

• Trabaja sobre tu proyecto. Lee y edita archivos, corre comandos y tests, busca por el repositorio y explica lo que encuentra. Cada acción que escribe, ejecuta o borra pasa por tu confirmación; el permiso es del CLI, no del modelo.
• Se orienta solo en el código. Al arrancar indexa el proyecto en tu máquina y mantiene memoria y un grafo del código entre sesiones, para no volver a empezar de cero cada vez. Además levanta un panel local para ver ese mapa y el esquema de tu base de datos.
• Arsenal incluido. 243 skills, 64 agentes, 77 comandos y 21 reglas empaquetados con el binario, listos desde la primera sesión. Catálogo: https://theus.pe/arsenal
• Conecta herramientas externas por MCP (servidores propios o de terceros), con el mismo flujo de permisos.
• Opera tu navegador cuando se lo pides: abrir páginas, leerlas, hacer clic, escribir, tomar capturas y leer consola y red para depurar tu web. Necesita la extensión de navegador de Theus; el comando /chrome te guía para instalarla.
• Graba y repite tareas de navegador (Kuti): grabas una vez, Theus entiende el paso y lo repite adaptándose; puedes exportar el guion y pasárselo a tu equipo.
• Control remoto (/wokitoki): sigues la sesión desde https://theus.pe/code y le escribes desde el móvil. Desde el remoto solo se aprueban acciones de lectura; lo que escribe o ejecuta sigue pidiendo confirmación en tu máquina.

Opcional: si instalas el motor de análisis Ñaupa (curl -fsSL https://theus.pe/naupa.sh | bash), Theus lo detecta y lo monta solo, y suma 19 herramientas de análisis del código —arquitectura, radio de impacto de un cambio, esquema de base de datos, código muerto, duplicados—. Es 100% local.

Los modelos

Theus no trae modelo propio. Tienes dos formas de darle uno, y las dos son de primera clase:

1. Local o con tu propia clave. Apunta el CLI a cualquier endpoint compatible con el estándar /v1/chat/completions —un motor corriendo en tu máquina, un gateway tuyo, tu propia clave—:

export THEUS_BASE_URL="http://127.0.0.1:11434/v1"
export THEUS_MODEL="tu-modelo"
export THEUS_API_KEY="local"
theus

Ningún servicio remoto es obligatorio para arrancar el CLI.

2. Suscripción Theus. theus login conecta el CLI al servicio de theus.pe: una sola cuenta te da acceso a un catálogo de 190 modelos de código, razonamiento y multimodal, escalonado por plan. Theus administra las claves de cada proveedor; tú no traes ninguna. El catálogo, con los nombres de cada modelo, está en https://theus.pe/#modelos, y la lista viva la devuelve GET /v1/models.

En modo suscripción el modelo por defecto es titan, el orquestador de Theus: analiza cada petición, decide si la resuelve con un modelo o la reparte entre varios, y sintetiza la respuesta.

Precios

En soles, IGV incluido. El plan anual cuesta diez mensualidades (dos meses gratis).

| Plan (en soles) | Al mes | Al año | Incluye | | --- | --- | --- | --- | | Free | S/ 0 | — | 25 créditos, sin tarjeta | | Pro Code | S/ 113 | S/ 1.130 | 1.500 créditos | | Studio AI | S/ 308 | S/ 3.080 | 5.000 créditos | | Max Agent | S/ 776 | S/ 7.760 | 15.000 créditos, multi-agente (hasta 4 subtareas por petición), visión ampliada e Higiene | | Omnipresente | S/ 1.049 | S/ 10.490 | 15.000 créditos + 300 imágenes + 1.320 créditos de vídeo, cada modalidad con su cuota propia | | Omnipotente | S/ 1.946 | S/ 19.460 | 40.000 créditos + 300 imágenes + 1.320 créditos de vídeo + consola empresarial |

El plan Free da para una sesión de trabajo, no para el día a día. Cada plan desbloquea lo del anterior y añade su tramo del catálogo.

Es la misma escalera que en dólares, cobrada en soles, y con los mismos nombres. Desde el 29 de agosto de 2026 cada plan en soles trae exactamente la cuota y las capacidades de su plan en dólares, y por eso se llama igual que él: es el mismo producto en otra moneda. Los nombres antiguos del riel en soles —Impulso, Pro, Power, Creativo y Empresa— quedaron retirados. El precio se deriva del precio en dólares al tipo de cambio único del producto (S/ 3,90 por dólar), redondeado al sol entero más cercano. En soles no se paga menos por lo mismo: se paga lo mismo en otra moneda.

Como los dos rieles comparten nombre, arriba se dice la moneda: Max Agent en soles son S/ 776 al mes con tarjeta peruana; Max Agent en dólares son USD 199 con tarjeta internacional. Es el mismo plan y la misma cuota.

El plan tope en soles se llama «Omnipotente» a secas. En dólares se vende como «Omnipotente + Atlas» porque incluye el bundle de la consola Atlas by Theus; el plan en soles no entrega Atlas, así que tampoco lleva el sufijo. Es la única asimetría de nombre de la escalera. Todo lo demás sí lo hereda.

Si ya estás suscrito, tu precio no cambia. El cobro recurrente en soles se funda con un importe fijo que queda congelado en la pasarela, así que esta tabla se aplica a las altas nuevas: mientras no te des de baja sigues pagando lo que aceptaste. La cuota nueva sí la heredas. Y el cambio de nombre no te mueve de plan: es el mismo plan, con el mismo identificador y la misma suscripción, solo que ahora se llama como su equivalente en dólares.

Se paga en soles desde Perú con tarjeta peruana; también con Yape en los packs de recarga prepago, que son un producto aparte de los planes y no cambiaron. Fuera de Perú se paga la misma escalera en dólares con tarjeta internacional. Detalle, precios anuales, packs y el precio vigente del gancho de fundador: https://theus.pe/precios

Higiene

Desde el escalón Max Agent hacia arriba —el mismo nombre en soles y en dólares, y el mismo escalón que abre el multi-agente—, el CLI trae Higiene: encuentra y quita las marcas invisibles que arrastra el texto generado —caracteres de ancho cero, controles de dirección que reordenan lo que ves sin cambiar lo que dice, caracteres de etiqueta, homóglifos— y los metadatos de procedencia de tus imágenes y documentos. Corre entera en tu máquina, no pasa por el servidor y no consume créditos. Se revisa o se limpia el proyecto con /higiene. Ese corte lo aplica el propio CLI como cortesía comercial, no el servidor: si no puede determinar tu plan, te deja pasar.

Soporte

• Novedades de cada versión: theus → /novedades, o https://theus.pe/novedades
• Diagnóstico de tu instalación: theus doctor
• Escríbenos: [email protected]

Theus es software propietario. Licencia en el archivo LICENSE del paquete.

Uso y planes

/uso muestra el porcentaje disponible del servicio Theus compartido con Web y Desktop. Con la politica v2 activa, muestra las ventanas de 5 horas y de 7 dias y sus renovaciones reales. Con la politica anterior muestra el ciclo actual, sin convertirlo en una supuesta semana. Si falta una lectura, lo indica.

/uso detalle conserva el historial y los costes que devuelve el servidor. Los modelos locales y las claves propias no gastan tu plan Theus; su detalle local sigue disponible con /cost.

/planes consulta el catalogo vigente. Free, Theus Pro, Theus Max y Theus Empresa son las nuevas opciones; sus precios y condiciones vienen del servicio. Si la oferta esta en preparacion, /upgrade no inicia la contratacion.

/potenciar activar autoriza continuar con saldo extra comprado cuando se agota el plan. /potenciar desactivar lo detiene y /potenciar estado consulta la configuracion. No compra recargas ni debita una tarjeta automaticamente. La compra sigue siendo explicita mediante /recarga.