Kurz:
- Agent Autoloop (MIT) ersetzt „Terminal bewachen“ durch „Event / Cron → eine Runde, dann Exit → Karte nur wenn nötig → Antwort setzt dieselbe Session fort“. README: macOS / Linux; natives Windows noch offen (Issue #17; WSL2 laut README nutzbar).
- Installation:
curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh, danachagent-autoloop try. - Messung am 6. November 2026 unter Linux: Node 24.22.2, agent-autoloop v1.5.0, Codex (aicodewith,
gpt-6.1-sol). Freigabeschleife OK — ~9 s bis zur Farbkarte, nach „Grün“ ~10 s auf derselben Session bis „Probelauf bestanden“. Ohne Desktop fehltenotify-send; CLI reichte. - Regeln in
~/.agent-autoloop/rules.json; prüfen mitagent-autoloop check. - Unbeaufsichtigt = lokale Rechte: Kartenlinks nicht teilen; Webhooks authentifizieren. Laut SECURITY ist Prompt-Injection nicht vollständig gelöst — Standard
edit, Nebenwirkungen überask.
API Key erstellen, Claude Code / Codex anbinden, Schleife starten →
Welches Problem
Claude Code oder Codex werden oft im beobachteten Terminal genutzt. Fenster zu = Arbeit stoppt.
Agent Autoloop baut auf einem deterministischen Kernel (~1650 Zeilen, null Runtime-Deps laut README) und Plugins:
- Event kommt — Cron 9:00, GitHub-Issue, Alert.
- Regeln verteilen — Agent + Arbeitsverzeichnis; gleiche Subjects werden zusammengeführt.
- Eine Runde, dann Exit — während Sie entscheiden, kein Agent-Prozess.
- Karte nur wenn nötig — Löschen, Neustart, ausgehende Nachrichten über Feishu / DingTalk / WeCom / Slack / Discord oder Desktop.
- Antwort setzt fort — dieselbe Unterhaltung.
Laut README: Claude Code, Codex, ACP mehrfach mit Session-Resume getestet; Feishu mit echter Zustellung. Webhooks teils nur gegen lokale Mocks.
Voraussetzungen
| Punkt | Anforderung |
|---|---|
| OS | macOS oder Linux. Natives Windows offen (#17); INSTALL beschreibt WSL2 |
| Runtime | Node.js 24+, Git, curl |
| Agent | Claude Code oder Codex (oder anderes CLI via command) |
| aicodewith-Key (optional) | API Key anlegen |
Bei uns: Node 22 → 24.22.2 mit n 24.
Schritt 0: API Key
- Bei aicodewith.ai registrieren, Schlüsselverwaltung.
- Schlüssel erstellen, sprechender Name (z. B.
autoloop-box). - Sofort kopieren. Siehe Create-API-Key-Doku.
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 = "IHR_API_KEY"
Claude Code — ~/.claude/settings.json:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
"ANTHROPIC_AUTH_TOKEN": "IHR_API_KEY"
}
}
Weiter: Codex-Installation, Codex API Key, config.toml, Claude-Code-Subagent, Conductor-Alternative.
Installation
curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh
App unter ~/.agent-autoloop/app. CI / headless: --no-service, dann agent-autoloop up (INSTALL).
Unser Lauf (2026-11-06, Asia/Shanghai): v1.5.0 (f211ca2de3b1), Agent Codex.
agent-autoloop --version
agent-autoloop doctor
agent-autoloop up
agent-autoloop try
Minimale Schleife: try → answer → status
Codex-Zeitlinie (UTC+8):
| Schritt | Zeit | Ergebnis |
|---|---|---|
| try | 15:25:01 → 15:25:10 | ~9 s, Karte „Farbe wählen“ |
| answer 1 2 | 15:25:27 | Grün; Runde 3, dieselbe Session |
| Ende | 15:25:27 → 15:25:37 | ~10 s, „Probelauf bestanden“ |
| Notify | — | notify-send fehlt; CLI OK |
agent-autoloop answer 1 2
agent-autoloop status
agent-autoloop why 3
Ehrlich: Erster try scheiterte am Modellnamen; mit gpt-6.1-sol OK. Claude-Code-Smoke ~6 s → OK; try lief über das Codex-Plugin.
rules.json schreiben
Morning Brief (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, nächster Lauf 11/07 09:00. Weitere Rezepte im Repo.
Claude Code, Codex und andere CLIs
use: claude, codex, acp, dsh oder command mit {prompt} als einem Argument. Claude Code / Codex / Cursor gleichrangig. Für parallele Worktrees: Conductor-Alternative.
Sicherheit
Laut SECURITY: lokale Rechte; Kartenlink 7 Tage gültig bei Besitz; Events wählen den Agenten nicht; Webhooks authentifizieren; CLI-Logins nicht proxied; Key-Configs nach dem Test löschen.
FAQ
Windows? Offen (#17); WSL2 dokumentiert. Systemdienst? Optional. try fehlgeschlagen? doctor, Node ≥ 24, Modell in der Liste, vollständiges experimental_bearer_token.
Fazit
Node 24 → installieren → try / answer / status → Cron-Regel → SECURITY beachten → Test-Keys entfernen.



