En resumen:
- Agent Autoloop (MIT) sustituye «vigilar el terminal» por «evento / cron → una ronda y salida → tarjeta solo si hace falta → tu respuesta reanuda la misma sesión». README: macOS / Linux; Windows nativo pendiente (issue #17; WSL2 por ahora).
- Instalación:
curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh, luegoagent-autoloop try. - Medición del 6 de noviembre de 2026 en Linux: Node 24.22.2, agent-autoloop v1.5.0, Codex (aicodewith,
gpt-6.1-sol). Bucle de aprobación OK — ~9 s hasta la tarjeta de color; tras responder «verde», ~10 s en la misma sesión hasta «prueba superada». Sin escritorio faltabanotify-send; el CLI bastó. - Reglas en
~/.agent-autoloop/rules.json; valida conagent-autoloop check. - Sin supervisión = permisos locales: no compartas enlaces de tarjeta; autentica webhooks. Según SECURITY, la inyección de prompts no está del todo resuelta —
editpor defecto, efectos secundarios conask.
Crea una API Key, conecta Claude Code / Codex y arranca el bucle →
Qué problema resuelve
Con Claude Code o Codex suele mirarse el terminal. Cerrar la ventana detiene el trabajo.
Agent Autoloop se centra en un kernel determinista (~1650 líneas, cero deps de runtime según el README) con plugins:
- Llega un evento — cron a las 9, issue de GitHub, alerta.
- Las reglas lo asignan — agente y directorio; mismos asuntos se fusionan.
- Una ronda y sale — mientras decides, no hay proceso del agente.
- Tarjeta solo si hace falta — borrados, reinicios, mensajes salientes vía Feishu / DingTalk / WeCom / Slack / Discord o escritorio.
- La respuesta reanuda — la misma conversación.
Según el README: Claude Code, Codex y ACP se probaron en multi-turno y reanudación; Feishu con entrega real. Webhooks / GitLab sobre todo contra mocks locales.
Requisitos
| Ítem | Requisito |
|---|---|
| SO | macOS o Linux. Windows nativo pendiente (#17); INSTALL documenta WSL2 |
| Runtime | Node.js 24+, Git, curl |
| Agente | Claude Code o Codex usable (u otro CLI con command) |
| Clave aicodewith (opcional) | Regístrate y crea una API Key |
En nuestra máquina: Node 22 → 24.22.2 con n 24.
Paso 0: crear una API Key
- Regístrate en aicodewith.ai, Gestión de claves.
- Crear clave, nombre claro (p. ej.
autoloop-box). - Copia la clave al momento. Ver la doc Create API Key.
Codex — ~/.codex/config.toml:
model = "gpt-6.1-sol"
model_provider = "aicodewith"
[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
experimental_bearer_token = "TU_API_KEY"
Claude Code — ~/.claude/settings.json:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
"ANTHROPIC_AUTH_TOKEN": "TU_API_KEY"
}
}
También: instalación de Codex, API Key de Codex, config.toml, subagente de Claude Code, alternativa a Conductor.
Instalación
curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh
App en ~/.agent-autoloop/app. CI / headless: --no-service y luego agent-autoloop up (INSTALL).
Nuestra corrida (2026-11-06, Asia/Shanghai): v1.5.0 (f211ca2de3b1), agente Codex.
agent-autoloop --version
agent-autoloop doctor
agent-autoloop up
agent-autoloop try
Bucle mínimo: try → answer → status
Línea de tiempo con Codex (UTC+8):
| Paso | Hora | Resultado |
|---|---|---|
| try | 15:25:01 → 15:25:10 | ~9 s, tarjeta de color |
| answer 1 2 | 15:25:27 | verde; ronda 3, misma sesión |
| Fin | 15:25:27 → 15:25:37 | ~10 s, «prueba superada» |
| Notify | — | sin notify-send; CLI OK |
agent-autoloop answer 1 2
agent-autoloop status
agent-autoloop why 3
Notas honestas: el primer try falló por un id de modelo ausente en aicodewith; con gpt-6.1-sol pasó. Smoke de Claude Code ~6 s → OK; este try usó el plugin de Codex.
Escribir rules.json
Brief matinal (README):
{
"name": "Morning brief",
"when": { "cron": "0 9 * * *" },
"to": "codex",
"cwd": "~/notes",
"prompt": "Summarize yesterday's notes and commits into today's brief."
}
check OK; rules explain: Asia/Shanghai, próximo 11/07 09:00. Más recetas en el repo.
Claude Code, Codex y otros CLI
use: claude, codex, acp, dsh o command con {prompt} como un solo argumento. Claude Code / Codex / Cursor son opciones pares. Para worktrees en paralelo: alternativa a Conductor.
Seguridad
Según SECURITY: privilegios locales; el enlace de tarjeta vale 7 días y quien lo tiene responde; los eventos no eligen el agente; autentica webhooks; no se proxifican logins CLI; borra configs con la clave tras la prueba.
FAQ
¿Windows? Pendiente (#17); WSL2 documentado. ¿Servicio del sistema? Opcional. ¿Falló try? doctor, Node ≥ 24, modelo en la lista, experimental_bearer_token completo.
Cierre
Node 24 → instalar → try / answer / status → regla cron → SECURITY → borrar claves de prueba.
Crea una API Key y escribe tu primera regla en segundo plano →



