Modos autónomos (beta)

Theus incluye capacidades autónomas: el modo proactivo, en el que el agente trabaja solo entre tus turnos dentro de la misma sesión; el modo asistente, una consola chat-first para operar tus sesiones de código remotas; y múltiples agentes, un orquestador multi-agente por scripts. Los dos primeros son beta opt-in y están apagados por defecto (no se activan solos); el de múltiples agentes viene disponible por defecto, pero tampoco hace nada por su cuenta: solo corre cuando tú ejecutas una orquestación.

Qué tienen en común

• Apagados por defecto. Sin la variable de entorno correspondiente ni la activación explícita, Theus se comporta exactamente como siempre: tú envías un turno, el agente responde, y espera tu siguiente instrucción.
• Opt-in en dos pasos. Primero la variable de entorno da elegibilidad (hace visible el modo); luego lo activas tú.
• Las acciones destructivas siguen pidiendo confirmación. Los modos autónomos no eluden el sistema de permisos: cualquier acción destructiva (escribir/borrar archivos, comandos peligrosos) se sigue confirmando igual que en una sesión normal.

Modo proactivo

El modo proactivo es in-REPL: el agente trabaja solo entre tus turnos, dentro de la misma sesión y en tu máquina. Cuando no hay nada que hacer, duerme (se detiene con la herramienta de espera); despierta cuando aparece trabajo o un mensaje que atender, avanza, y vuelve a dormir. No abre puertos, no usa red nueva ni depende de infraestructura adicional: es el mismo bucle del agente, capaz de continuar por su cuenta.

Cómo se activa

Es beta opt-in en dos pasos, apagado por defecto:

1. Elegibilidad — arranca Theus con la variable de entorno que hace visible el modo:

   THEUS_PROACTIVE=1 theus

2. Activación — dentro de la sesión, enciéndelo con el comando de barra, o arranca ya activo con el flag:

   /proactive on          # activa el modo proactivo en la sesión
   theus --proactive      # arranca con el modo proactivo ya activo

El comando /proactive (alias /proactivo) admite on, off, pause, resume y status para controlar y consultar el modo durante la sesión.

Modo asistente

El modo asistente es una consola chat-first pensada para descubrir y operar tus sesiones de código remotas desde una conversación: te conectas a una sesión que corre en la nube de Theus y la diriges desde el chat, sin estar tú mismo dentro de esa sesión.

Cómo se activa

Es beta opt-in, apagado por defecto. La variable de entorno lo hace elegible:

THEUS_KAIROS=1 theus

Con la elegibilidad puesta, abre el modo desde el REPL:

/assistant             # descubre tus sesiones remotas y te deja conectarte a una

Si no hay ninguna sesión remota disponible, el modo te lo indica en lugar de inventar una. Sin THEUS_KAIROS=1 el comando no aparece: publicar esta documentación no lo activa para nadie.

Múltiples agentes

Una orquestación de múltiples agentes coordina varios subagentes desde una sola receta —en paralelo, en cadena o por fases— y reúne sus resultados por ti. Cada subagente trabaja aislado; puede usar tus herramientas, incluido el grafo de código de Theus (Ñaupa), y las recetas verifican su propio trabajo de forma adversarial antes de darlo por bueno. La defines con agent(), parallel() (en barrera), pipeline() (sin barrera, encadena el resultado anterior), phase() y log(), y corre como tarea en segundo plano.

Recetas de fábrica

No empiezas de cero: Theus trae orquestaciones listas que navegan tu código con Ñaupa y verifican sus hallazgos.

• revisar-cambios — mapea el impacto de tu diff por el grafo → revisa por dimensiones (corrección, seguridad, rendimiento, tests) → verifica cada hallazgo con escépticos.
• auditar-seguridad — barrido de seguridad multi-lente del proyecto.
• auditoria-codigo — auditoría amplia de calidad (seguridad, rendimiento, mantenibilidad).
• entender-modulo — explica un módulo usando el grafo de dependencias.
• documentar — genera documentación verificada contra el código.
• implementacion-verificada — implementa un cambio en un worktree aislado y lo verifica adversarialmente antes de proponerlo.

Ejecuta una con /multiplesagentes revisar-cambios, o crea la tuya en .theus/workflows/<nombre>.js. /multiplesagentes (sin argumentos) se explica solo; /multiplesagentes ayuda trae la guía completa de la API.

Constelación de agentes (UI en vivo)

Mientras una orquestación corre, pulsa Shift+↓ para abrir la Constelación de agentes: un mapa animado en tiempo real donde cada subagente es un nodo que pulsa mientras trabaja, agrupado por fase en columnas, con las conexiones de paralelo y cadena, barra de progreso y contadores. Respeta el modo de movimiento reducido.

Disponibilidad

El comando /multiplesagentes (con alias /workflows) y la herramienta de orquestación están disponibles por defecto — aparecen en la lista de comandos sin configurar nada. Para desactivarlos, arranca con THEUS_WORKFLOWS=0. Cada corrida se guarda en .theus/workflows/runs/ para revisarla después, y toda acción destructiva sigue pasando por el sistema de permisos.

Resumen