iCode Agent · Guía · Automatización
Automatiza en scripts y CI.
iCode Agent es un agente de terminal, pero no necesita una terminal. Las mismas tareas que ejecutas de forma interactiva se ejecutan sin interfaz con -p, y el flujo completo de eventos del runtime está disponible como JSON.
Modo de impresión
Ejecuta una tarea, imprime la respuesta final y sal:
icode-agent -p "run the tests and report failures" /path/to/project
El espacio de trabajo se puede pasar como argumento o establecer con --cwd <dir>. El modo de impresión sale con 0 cuando la ejecución llegó a una respuesta final y con 1 en caso contrario, así que puedes usarlo para bifurcar en un script.
Modo de eventos JSON
Añade --mode json para transmitir cada evento de ejecución como una línea JSON, seguida de una línea de resultado final. Este es el modo para herramientas: obtienes el progreso del agente como datos, no como salida de terminal.
icode-agent --mode json -p "find all TODO comments" /path/to/project
El flujo incluye eventos como:
run_start: la tarea y la identidad del modelo.iteration_start,assistant_delta: progreso dentro de cada paso.tool_callytool_result: cada herramienta que usó el agente y lo que devolvió.model_response: uso de tokens de la llamada, cuando el proveedor lo informa.compaction,projection_reduced: eventos de gestión del contexto, para que el comportamiento del coste sea visible en el flujo.run_end: el resumen de la ejecución.
Cada línea es un objeto JSON completo, así que las herramientas estándar —jq, una canalización de logs, un paso de CI— pueden consumirlo directamente.
Continuar una sesión
Las sesiones del espacio de trabajo persisten automáticamente. Continúa la más reciente o retoma una concreta por id:
# 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 ejemplo de CI
Un paso que pide al agente que haga pasar la suite y que falla el trabajo cuando devuelve un valor distinto de cero:
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
Instrucciones y configuración del proyecto
Las ejecuciones sin interfaz leen la misma configuración que las interactivas:
AGENTS.md(oCLAUDE.md) en la raíz del repositorio se carga en el prompt del sistema, para que las ejecuciones de CI sigan las reglas de tu proyecto.- La configuración global está en
~/.icode-agent/settings.jsony se puede sobrescribir por proyecto en.icode-agent/settings.json. - Las plantillas de prompt (
.icode-agent/prompts/*.md) y las skills (.icode-agent/skills/<name>/SKILL.md) se cargan automáticamente.
En un runner de CI sin ~/.icode-agent, apunta ICODE_AGENT_CONFIG_DIR a un directorio preparado para que la configuración del modelo esté disponible.