En bref :
- Agent Autoloop (MIT) remplace « garder le terminal » par « événement / cron → un tour puis sortie → carte si besoin → votre réponse reprend la même session ». README : macOS / Linux ; Windows natif en attente (issue #17 ; WSL2 indiqué pour l’instant).
- Installation :
curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh, puisagent-autoloop try. - Mesure du 6 novembre 2026 sous Linux : Node 24.22.2, agent-autoloop v1.5.0, Codex (clé aicodewith,
gpt-6.1-sol). Boucle d’approbation OK — ~9 s jusqu’à la carte couleur, puis ~10 s après « vert » sur la même session jusqu’à « essai réussi ». Sans bureau,notify-sendabsent ; le CLI suffit. - Règles dans
~/.agent-autoloop/rules.json;agent-autoloop checkpour valider. - Sans surveillance = permissions locales : ne partagez pas les liens de carte ; authentifiez les webhooks. Selon SECURITY, l’injection de prompt n’est pas entièrement résolue —
editpar défaut, effets de bord viaask.
Créer une API Key, brancher Claude Code / Codex, lancer la boucle →
Quel problème ça résout
Avec Claude Code ou Codex, on surveille souvent un terminal. Fermer la fenêtre arrête le travail.
Agent Autoloop s’appuie sur un kernel déterministe (~1650 lignes, zéro dépendance runtime d’après le README) et des plugins :
- Un événement arrive — cron 9 h, issue GitHub, alerte.
- Les règles dispatchent — agent + répertoire ; fusion des événements du même sujet.
- Un tour puis sortie — pendant que vous décidez, aucun processus agent.
- Carte seulement si besoin — suppressions, redémarrages, messages sortants, via Feishu / DingTalk / WeCom / Slack / Discord ou notification bureau.
- Une réponse reprend — même conversation.
D’après le README : Claude Code, Codex et ACP ont été testés en multi-tours et reprise de session ; Feishu en livraison réelle. Webhooks / GitLab surtout contre mocks locaux.
Prérequis
| Élément | Exigence |
|---|---|
| OS | macOS ou Linux. Windows natif en attente (#17) ; INSTALL documente WSL2 |
| Runtime | Node.js 24+, Git, curl |
| Agent | Claude Code ou Codex déjà utilisable (ou autre CLI via command) |
| Clé aicodewith (optionnel) | Créer une API Key |
Chez nous : Node 22 → 24.22.2 via n 24, puis installation OK.
Étape 0 : créer une API Key
- Inscription sur aicodewith.ai, Gestion des clés.
- Créer une clé, nom clair (ex.
autoloop-box). - Copiez la clé tout de suite. Voir 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 = "VOTRE_API_KEY"
Claude Code — ~/.claude/settings.json :
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
"ANTHROPIC_AUTH_TOKEN": "VOTRE_API_KEY"
}
}
Voir aussi installation Codex, clé API Codex, config.toml Codex, sous-agent Claude Code, alternative Conductor / worktree.
Installation
curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh
App dans ~/.agent-autoloop/app. CI / sans GUI : --no-service puis agent-autoloop up (INSTALL).
Notre run (2026-11-06, Asia/Shanghai) : v1.5.0 (commit f211ca2de3b1), Agent Codex, canal bureau.
agent-autoloop --version
agent-autoloop doctor
agent-autoloop up
agent-autoloop try
Boucle minimale : try → answer → status
Chronologie Codex (UTC+8) :
| Étape | Heure | Résultat |
|---|---|---|
| try | 15:25:01 → 15:25:10 | ~9 s, carte « choisir une couleur » |
| answer 1 2 | 15:25:27 | vert ; tour 3, même session |
| Fin | 15:25:27 → 15:25:37 | ~10 s, « essai réussi » |
| Notify | — | notify-send manquant ; CLI OK |
agent-autoloop answer 1 2
agent-autoloop status
agent-autoloop why 3
Notes honnêtes : premier try échoué (modèle absent sur aicodewith) ; après model = "gpt-6.1-sol", OK. Smoke Claude Code ~6 s → OK ; la boucle try a utilisé le plugin Codex.
Écrire 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, prochain run 11/07 09:00. Exemple GitHub issues dans le dépôt.
Claude Code, Codex et autres CLI
use : claude, codex, acp, dsh, ou command avec {prompt} en un seul argument. Claude Code / Codex / Cursor sont des options neutres côte à côte. Pour le parallélisme worktree, voir l’alternative Conductor.
Sécurité
Selon SECURITY : permissions locales ; liens de carte = possession pendant 7 jours ; les événements ne choisissent pas l’agent ; webhooks à authentifier ; pas de proxy des login CLI ; nettoyer les configs contenant la clé après test.
FAQ
Windows ? En attente (#17) ; WSL2 documenté. Service système ? Optionnel. try échoue ? doctor, Node ≥ 24, modèle listé sur pricing, experimental_bearer_token complet.
Pour finir
Node 24 → installer → try / answer / status → règles cron → respecter SECURITY → supprimer les clés de test.



