Sobre el proyecto

agent-runner es una herramienta de supervisión para mantener en ejecución continua CLIs de codificación autónoma. Reinicia los procesos del agente después de cada ronda e incluye ajustes predefinidos para Claude Code, aider, gemini, codewhale, kimi y pi, además de soportar cualquier CLI con argumentos de prompt mediante configuración personalizada. La herramienta se organiza en torno a un modelo de tres capas: la Ronda (una invocación del agente), el Bucle (un bucle de reinicio con captura de señales) y el Testigo (un monitor con 14 detectores y parada automática). Proporciona 15 defensas con nombre estructuradas como datos, incluyendo presupuestos de tiempo por ronda, aislamiento de grupos de procesos, idempotencia de almacenamiento de huérfanos, almacenamientos bloqueados por SHA, clasificación por diferencia de conjuntos y comprobaciones de arranque. Cada defensa documenta el incidente histórico que aborda y cuenta con una prueba invariante. El componente de monitor ejecuta 14 detectores sobre los registros locales del proyecto supervisado, cubriendo problemas como tasas de tiempo de espera, rondas colgadas, cadenas de huérfanos, advertencias y crecimiento de disco, presión de memoria, fallos de red, limitación de velocidad y anomalías repetitivas. Dos detectores pueden detener automáticamente el servicio cuando continuar sería perjudicial: fallos de OAuth que consumen la cuota de API y condiciones críticas de disco. Un freno suave opcional puede limitar el uso de memoria bajo presión sostenida. agent-runner expone 17 verbos de comando para la gestión del ciclo de vida (init, install, start, stop, restart, kill, upgrade, migrate) y la observación (peek, watch, monitor, events, status, doctor). Admite unidades de usuario de systemd para los procesos serve y monitor, ventanas programadas de ejecución/pausa, salida JSON para consumidores posteriores y retransmisión remota de eventos mediante conexiones SSH gestionadas, manteniendo la detección en el host. El proyecto incluye documentación extensa que cubre inicio rápido, referencia de comandos, esquema de configuración, resolución de problemas para operadores y arquitectura. Es exclusivo de POSIX (Linux, macOS), probado con Python 3.11+ en x86_64 y aarch64, y está licenciado bajo Apache 2.0.