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_call und tool_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 (oder CLAUDE.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.json und 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.