iCode Agent · ガイド · 自動化
スクリプトと CI で自動化する。
iCode Agent はターミナルエージェントですが、ターミナルを必要としません。対話的に実行するのと同じタスクを -p でヘッドレス実行でき、ランタイムの完全なイベントストリームを JSON で取得できます。
プリントモード
タスクを 1 つ実行し、最終応答を出力して終了します。
icode-agent -p "run the tests and report failures" /path/to/project
ワークスペースは引数で指定するか、--cwd <dir> で設定できます。プリントモードは、実行が最終回答に達した場合は 0、それ以外は 1 で終了するため、スクリプトで分岐できます。
JSON イベントモード
--mode json を追加すると、すべての実行イベントが JSON 行としてストリームされ、最後に結果行が続きます。これはツール向けのモードで、エージェントの進捗をターミナル出力ではなくデータとして受け取れます。
icode-agent --mode json -p "find all TODO comments" /path/to/project
ストリームには次のようなイベントが含まれます。
run_start— タスクとモデルの識別情報。iteration_start、assistant_delta— 各ステップ内の進捗。tool_callとtool_result— エージェントが使ったすべてのツールと、その戻り値。model_response— プロバイダーが報告する場合の、呼び出しごとのトークン使用量。compaction、projection_reduced— コンテキスト管理のイベント。コストの挙動をストリームで確認できます。run_end— 実行のサマリー。
各行が完全な JSON オブジェクトなので、jq、ログパイプライン、CI ステップといった標準的なツールでそのまま扱えます。
セッションを続ける
ワークスペースのセッションは自動的に永続化されます。最新のセッションを続けるか、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
CI の例
エージェントにテストスイートを成功させるよう指示し、非ゼロで終了したらジョブを失敗させるステップです。
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
プロジェクトの指示と設定
ヘッドレス実行は対話実行と同じ設定を読み込みます。
- リポジトリルートの
AGENTS.md(またはCLAUDE.md)はシステムプロンプトに読み込まれるため、CI の実行もプロジェクトのルールに従います。 - グローバル設定は
~/.icode-agent/settings.jsonにあり、プロジェクトごとに.icode-agent/settings.jsonで上書きできます。 - プロンプトテンプレート(
.icode-agent/prompts/*.md)とスキル(.icode-agent/skills/<name>/SKILL.md)は自動的に読み込まれます。
~/.icode-agent のない CI ランナーでは、準備したディレクトリを ICODE_AGENT_CONFIG_DIR に指定して、モデル設定を利用できるようにします。