# 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: - Documentación: - Estado del servicio: --- ## Instalación ```bash 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 ```bash 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: ```bash theus -c # retoma la conversación más reciente de esta carpeta theus -r # abre el selector y eliges cuál retomar theus -r # 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: - **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 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—: ```bash 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 , 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: ## 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 - Diagnóstico de tu instalación: `theus doctor` - Escríbenos: **contacto@theus.pe** 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`.