ADE「Orca」で複数の AI エージェントを並列に動かす

Orca は、タスクごとに Git の worktree を分け、複数の AI コーディングエージェントを並列で動かす開発環境です。開発元は ADE（Agent Development Environment）と位置づけており、公式サイトのキャッチコピーは「Ship 100x with the agent IDE」です。この記事では、Orca の基本の流れと主な機能、エージェントが別のエージェントに作業を依頼できる Orchestration、そして使う前に確認しておきたい注意点を紹介します。

Orca は「エージェントを働かせるための IDE」

Orca は、人がコードを書くための IDE とは目的が違います。複数の AI エージェントを並べて働かせ、その結果を人が確認してまとめる、という使い方を前提に作られています。

基本の流れは 6 段階です。

macOS では Homebrew で入ります。

brew install --cask stablyai/orca/orca

Orca 自体は無料で、MIT ライセンスで公開されています。Claude Code や Codex などのエージェントは、利用者が自分の契約を持ち込みます（公式サイト）。

並列化の土台になっている Git の worktree そのものの使い方は、Git Worktree でコーディングエージェントを並列化する で紹介しています。Orca は、worktree の作成からエージェントの起動、差分の確認、PR 作成までを 1 つのアプリにまとめたものです。

主な機能

Orca の機能は、エージェントの状態管理・作業の開始・環境の準備・レビュー・画面確認・実行場所の 6 つの領域に分かれます。順に見ていきます。

エージェントの状態を一覧で見る

動いているエージェントの状態は、アイコンで一覧表示されます。作業中・入力待ち・完了・失敗の区別が付き、作業が終わると通知が届きます。エージェントを何体も並べると「どれを見に行けばいいか」が分からなくなりがちですが、一覧があれば手が空いたものから順に確認できます。

Orca を終了しても、エージェントは裏で動き続けます。 エージェントごとの使用量も表示され、アカウントは再ログインなしで切り替えられます。

課題を選んで作業を始める

作業は課題（Issue）から始められます。課題を選び、担当させるエージェントを選ぶと、worktree の作成と同時にエージェントが起動します。公式ドキュメントでこの流れが案内されているのは、GitHub と Linear の課題です。課題を読んでブランチを切り、ターミナルでエージェントを立ち上げる、という手作業がまとめて省けます。

orca.yaml でセットアップを共有する

新しく作った worktree には、gitignore されている node_modules や .env が入っていません。worktree を作るたびに依存関係を入れ直すと、並列化の手間が増えてしまいます。Orca では、リポジトリ直下の orca.yaml にセットアップ手順を書いておけます。

orca.yaml はリポジトリにコミットできるので、チームの全員が同じ手順で worktree を作れます。sharedDirectories の書き方は公式ドキュメントに例があります。

# orca.yaml (リポジトリ直下)
worktree:
  sharedDirectories:
    - node_modules
    - .cache

差分にコメントして、まとめて差し戻す

差分ビューでは、行ごとに指摘を書けます。書いた指摘はまとめて 1 回でエージェントに渡せるので、指摘を 1 件ずつ送って修正を待つ往復が減ります（公式ドキュメント）。

差分の上では、AI が書いた行に印が付きます。 人が手で直した行は印が外れるので、どこを人が確認済みで、どこがエージェントの書いたままなのかを見分けられます（公式ドキュメント）。

ブラウザと Design Mode で画面を確かめる

worktree ごとにブラウザが内蔵されていて、開発中の画面をその場で開けます。Design Mode では、画面の要素をクリックすると、その要素の HTML・CSS・画像がエージェントに届きます。「このボタンの位置を揃えて」のような指示を、対象の要素を指したうえで出せます。

エージェントの側も、このブラウザを使って自分で画面を開いて操作し、スクリーンショットで結果を確かめられます。変更したあとの動作確認までエージェントに任せられるのが特徴です。

実行場所を選ぶ

エージェントを動かす場所は 4 通りから選べます。

手元の PC の性能が足りないときや、出先からスマートフォンで進み具合を確認したいときは、リモートの実行場所が役に立ちます（公式ドキュメント）。

orca CLI と定期実行

Orca には orca コマンドが付属していて、画面で行う操作の多くを CLI から実行できます。エージェント自身もこの CLI を使えるので、エージェントに Orca を操作させることができます。

Orca のターミナルの中では設定なしで使えます。外部のターミナルから使う場合は、Settings で登録が必要です。

automations でプロンプトを定期実行する

orca automations を使うと、決まったプロンプトをスケジュールに沿ってエージェントに実行させられます。主な設定項目は次のとおりです。

• エージェント（--provider）: 実行させるエージェントを指定する（必須）
• スケジュール（--trigger）: 毎時・毎日・平日・毎週のプリセットか、cron 形式で指定する
• 実行場所（--repo / --workspace）: 毎回新しい worktree を作るか、既存の worktree で実行するかを選ぶ
• 結果（automations runs）: エージェントの出力は実行履歴に残り、あとから読める

公式ドキュメントの例をもとにすると、平日 9 時に Issue を整理させる定期実行は次のように作れます。

orca automations create \
  --name "Weekday triage" \
  --trigger weekdays \
  --time 09:00 \
  --prompt "Triage new issues and summarize blockers" \
  --provider claude \
  --repo my-repo \
  --disabled \
  --json

公式ドキュメントは、まず --disabled で作成し、手動で実行して確かめてから有効にする手順を勧めています。

Orchestration でエージェントに作業を依頼させる

Orca ならではの機能が Orchestration です。コーディネーター役のエージェントが、ほかのエージェント（ワーカー）に作業を依頼し、完了の報告を受け取れます。人がエージェントを 1 体ずつ見て回る代わりに、エージェントどうしで作業を受け渡せるということです。

構成要素

Orchestration は 5 つの要素で組み立てられています（公式ドキュメント）。

依頼から片付けまでの流れ

コーディネーターは、Run の作成・依頼・報告待ち・片付けの順に進めます。

worker-start で worktree とエージェントを用意して指示を送り、check --wait で完了報告や質問が届くまで待ちます。--worktree new-child を指定すると、ワーカー用の worktree が新しく作られます（current はコーディネーターと同じ worktree で動かす指定です）。届いた報告を処理したら、check --ack <deliveryId> で受領を返します。受領を返さないと、同じ報告が繰り返し届きます。 結果を確かめてから worker-release でワーカーを終えます。完了報告は「成功／失敗」と変更ファイルを含む決まった形式で届くので、コーディネーターは報告を読み違えずに次の判断へ進めます。

orca orchestration run-create --objective "..." --json
orca orchestration task-create --spec "..." --task-title "..." --json
orca orchestration worker-start --task <taskId> --worktree new-child --name <name> --agent codex --json
orca orchestration check --wait --types worker_done,escalation,question --timeout-ms 900000 --json
orca orchestration check --ack <deliveryId> --wait --types worker_done,escalation,question --timeout-ms 900000 --json
orca orchestration worker-release --dispatch <dispatchId> --json

公式ドキュメントでは、Orchestration は Settings → Experimental で有効にしてから使うよう案内されています。ただし、Orca 1.4.210 では Experimental の切り替えが見当たりませんでした。更新が速いツールなので、使う前に手元のバージョンと画面を確かめてください。

同じ指示を複数のエージェントに出して比べる

Orca の並列実行が活きる使い方の 1 つが、同じ指示を複数のエージェントに出して結果を比べる方法です。

1. worktree を 3 つ作る
2. それぞれで別々のエージェントを起動する
3. 3 つに同じ指示を入力する
4. 最も良い差分を採用する

結果が一致すれば正しい可能性が高く、割れた箇所はそのタスクの難しい部分だと分かります。 1 体のエージェントの出力だけを見ていると気付きにくい「迷いやすい箇所」が、差分の割れ方として見えるのが利点です。

普段から Orca を使っているメンバーは、この比較を定期実行と組み合わせています。手元にあるのが Claude のアカウントだけなので、Sonnet や Opus など Claude のモデルどうしで同じタスクを定期的に実行させ、判定結果から一番良い案を採用する、という運用を繰り返しています。Codex と Claude のどちらにどの機能を任せるのが良いか、といったエージェントをまたぐ比較はまだ試せていません。

使う前に確認したい注意点

Orca は、エージェントに多くの操作を任せられる分、既定の設定のまま使うと影響が大きくなる箇所があります。

とくに気を付けたいのは権限の既定値です。 worktree は作業ディレクトリを分けるだけで、エージェントがファイルシステムやネットワークに触れる範囲は制限しません。権限確認なしで起動したエージェントは、指示の解釈がずれたときに、CI のワークフローを消すような意図しない変更まで進めてしまうことがあります。権限は Settings → Agents → Agent Permissions で Manual に変更できるので、最初は Manual にして挙動を確かめてから緩めるのが安全です。

どの操作をエージェントに許可し、どこで人の承認を挟むかの考え方は、コーディングエージェントの権限設計 で整理しています。エージェントが使う認証情報にも、作業に必要な最小限の権限だけを付けておきましょう。

まとめ

Orca は、タスクごとに worktree を分け、複数のエージェントを並列で動かす開発環境です。

並列で動かすエージェントが増えてきて、worktree の準備や差分の確認に手間がかかっている場合は、まず権限を Manual にしたうえで Orca を試してみてはいかがでしょうか。エージェントの状態管理に寄せたターミナルランタイムを使う方法は、Codex アプリと Herdr でマルチ AI を動かす で紹介しています。

gaipack では、AI コーディングエージェントを使った開発の進め方を社内で試しながら改善しています。AI 駆動開発の導入をご検討中の方は、お気軽にご相談ください。