iCode Agent · Anleitung · Automatisierung
In Skripten und CI automatisieren.
iCode Agent ist ein Terminal-Agent, braucht aber kein Terminal. Dieselben Aufgaben, die du interaktiv ausführst, laufen mit -p headless, und der vollständige Ereignisstrom der Laufzeit ist als JSON verfügbar.
Print-Modus
Führe eine Aufgabe aus, gib die endgültige Antwort aus und beende den Lauf:
icode-agent -p "run the tests and report failures" /path/to/project
Der Arbeitsbereich kann als Argument übergeben oder mit --cwd <dir> gesetzt werden. Der Print-Modus beendet sich mit 0, wenn der Lauf eine endgültige Antwort erreicht hat, andernfalls mit 1 — so kannst du in einem Skript danach verzweigen.
JSON-Ereignismodus
Füge --mode json hinzu, um jedes Laufereignis als JSON-Zeile zu streamen, gefolgt von einer abschließenden Ergebniszeile. Das ist der Modus für Tooling: Du erhältst den Fortschritt des Agenten als Daten, nicht als Terminalausgabe.
icode-agent --mode json -p "find all TODO comments" /path/to/project
Der Stream enthält unter anderem Ereignisse wie:
run_start— die Aufgabe und die Modellidentität.iteration_start,assistant_delta— Fortschritt innerhalb jedes Schritts.tool_callundtool_result— jedes vom Agenten verwendete Tool und was es zurückgegeben hat.model_response— Token-Verbrauch für den Aufruf, wenn der Anbieter ihn meldet.compaction,projection_reduced— Kontextmanagement-Ereignisse, damit das Kostenverhalten im Stream sichtbar ist.run_end— die Zusammenfassung des Laufs.
Jede Zeile ist ein vollständiges JSON-Objekt, sodass Standardwerkzeuge — jq, eine Log-Pipeline, ein CI-Schritt — es direkt verarbeiten können.
Eine Sitzung fortsetzen
Arbeitsbereichs-Sitzungen bleiben automatisch erhalten. Setze die letzte fort oder nimm eine bestimmte per ID wieder auf:
# continue the most recent session in this workspace icode-agent -c -p "now fix the issue you found" /path/to/project # resume a specific session icode-agent --resume <id> -p "add tests for that fix" /path/to/project
Ein CI-Beispiel
Ein Schritt, der den Agenten bittet, die Testsuite bestehen zu lassen, und den Job fehlschlagen lässt, wenn er einen Wert ungleich null zurückgibt:
icode-agent -p "run the full test suite and fix any failures" "$PWD" status=$? if [ "$status" -ne 0 ]; then echo "iCode Agent did not reach a passing state." >&2 exit 1 fi
Projektanweisungen und Einstellungen
Headless-Läufe lesen dieselbe Konfiguration wie interaktive:
AGENTS.md(oderCLAUDE.md) im Repository-Stamm wird in den System-Prompt geladen, damit CI-Läufe den Regeln deines Projekts folgen.- Globale Einstellungen liegen unter
~/.icode-agent/settings.jsonund können pro Projekt unter.icode-agent/settings.jsonüberschrieben werden. - Prompt-Vorlagen (
.icode-agent/prompts/*.md) und Skills (.icode-agent/skills/<name>/SKILL.md) werden automatisch geladen.
Auf einem CI-Runner ohne ~/.icode-agent verweise ICODE_AGENT_CONFIG_DIR auf ein vorbereitetes Verzeichnis, damit die Modellkonfiguration verfügbar ist.