iCode Agent · Guide · Automatisation

Automatisez dans les scripts et la CI.

iCode Agent est un agent terminal, mais il n’a pas besoin d’un terminal. Les mêmes tâches qu’en interactif s’exécutent sans interface avec -p, et le flux d’événements complet de l’environnement d’exécution est disponible en JSON.

Mode impression

Exécutez une tâche, imprimez la réponse finale et quittez :

icode-agent -p "run the tests and report failures" /path/to/project

L’espace de travail peut être fourni en argument ou défini avec --cwd <dir>. Le mode impression se termine avec le code 0 lorsque l’exécution a atteint une réponse finale, et 1 sinon — vous pouvez donc tester ce code dans un script.

Mode événements JSON

Ajoutez --mode json pour diffuser chaque événement d’exécution sous forme de ligne JSON, suivie d’une ligne de résultat finale. C’est le mode pour l’outillage : vous obtenez la progression de l’agent sous forme de données, et non de sortie terminal.

icode-agent --mode json -p "find all TODO comments" /path/to/project

Le flux comprend des événements tels que :

  • run_start — la tâche et l’identité du modèle.
  • iteration_start, assistant_delta — la progression au sein de chaque étape.
  • tool_call et tool_result — chaque outil utilisé par l’agent et ce qu’il a renvoyé.
  • model_response — l’usage de tokens pour l’appel, lorsque le fournisseur le signale.
  • compaction, projection_reduced — des événements de gestion du contexte, afin que le comportement des coûts soit visible dans le flux.
  • run_end — le résumé de l’exécution.

Chaque ligne est un objet JSON complet, que des outils standard — jq, un pipeline de logs, une étape de CI — peuvent consommer directement.

Reprendre une session

Les sessions de l’espace de travail sont conservées automatiquement. Reprenez la plus récente, ou reprenez une session précise par son identifiant :

# 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

Un exemple de CI

Une étape qui demande à l’agent de faire passer la suite et fait échouer le job lorsque le code de retour est non nul :

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

Instructions et paramètres du projet

Les exécutions sans interface lisent la même configuration que les exécutions interactives :

  • AGENTS.md (ou CLAUDE.md) à la racine du dépôt est chargé dans le prompt système, afin que les exécutions en CI suivent les règles de votre projet.
  • Les paramètres globaux se trouvent dans ~/.icode-agent/settings.json et peuvent être surchargés pour chaque projet dans .icode-agent/settings.json.
  • Les modèles de prompts (.icode-agent/prompts/*.md) et les skills (.icode-agent/skills/<name>/SKILL.md) se chargent automatiquement.

Sur un runner de CI sans ~/.icode-agent, pointez ICODE_AGENT_CONFIG_DIR vers un répertoire préparé pour que la configuration du modèle soit disponible.