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 に指定して、モデル設定を利用できるようにします。