Orca 是為 AI coding agents 設計的 worktree IDE。它讓多個 CLI agent 在各自的 Git worktree 中執行，並把終端、編輯、瀏覽器、差異審查與提交流程集中在同一個工作介面。
Orca 將每項功能或錯誤修正放進獨立的 Git worktree。每個 worktree 擁有自己的分支、檔案與 agent terminals，因此多個 agent 不會同時覆寫同一份工作目錄。
使用者可在同一個專案中啟動 Codex、Claude Code、OpenCode、Pi 或其他可從終端執行的 CLI agent。Orca 負責呈現各工作區狀態、終端、編輯器、瀏覽器與差異；agent 仍使用使用者自己的供應商訂閱與命令列工具。
標準生命週期包含建立工作區、執行任務、審查差異、提交與推送，以及封存或刪除。所有 worktree 都是真實的 Git worktree，也可直接使用 git status、git rebase 與 git cherry-pick。
從 Orca 官方下載頁選擇 macOS、Windows 或 Linux 安裝檔。macOS 也可使用 Homebrew；Arch Linux 可從 AUR 安裝。
使用 AUR binary package；若要選擇其他平台或歷史版本，改從官方下載頁或 GitHub Releases 取得安裝檔。
Settings → General → Orca CLI 完成註冊，再執行 command -v orca 與 orca status --json；兩個命令都成功後再交給 agent 使用。
Orca 將多 agent 執行、程式碼審查與遠端工作區放在同一個產品模型中。先依任務的隔離需求建立 worktree，再選擇終端、瀏覽器、行動端或 SSH 功能。
| 任務 | 使用功能 | 可觀察結果 |
|---|---|---|
| 比較多個 agent 的同題實作 | Parallel Worktrees | 每個方案位於獨立分支與 diff |
| 修正瀏覽器中的 UI 元素 | Design Mode | agent 收到 DOM、樣式與裁切畫面 |
| 在遠端主機執行長時間任務 | SSH Worktrees | agent 在遠端執行，本機顯示編輯器與 diff |
| 將多個行內意見送回 agent | Annotate AI Diff | 註解以單一批次進入修正回合 |
平行執行依賴工作目錄隔離、明確的共享檔案策略與人工審查。以下規則均來自 Orca 官方文件。
從明確的 base ref 建立 worktree。比較完成後，保留被選取的分支；刪除其他 worktree 前先確認其中沒有需要保留的提交。
來源 · Orca Docs / Worktrees新 worktree 不包含 gitignored dependencies、cache 與 secrets。大型可重建目錄使用 Shared Paths 或 worktree.sharedDirectories；需要獨立副本的設定使用 .worktreeinclude。
先在 diff 中完成行內註解，再使用 Send to agent 一次送出。agent 修正後保留原註解，逐項確認並標記 Resolve。
來源 · Orca Docs / Annotate AI Diff封裝版應用程式會傳送匿名產品使用事件。若政策要求停用，請在 Settings → Privacy 關閉，或設定 DO_NOT_TRACK=1、ORCA_TELEMETRY_DISABLED=1。
以下流程依官方「Your first 3-agent session」整理。目標是讓三個 agent 從相同 base ref 處理同一項任務，再以 diff 與測試結果選擇保留的實作。
每個候選方案必須保有獨立 diff 與測試證據。選擇結果後，先確認修正意見已處理，再提交被選取的分支；未被採用的 worktree 不得含有未保存的提交。
worktree.sharedDirectories 或 .worktreeinclude，不要假設 dependency、cache 或本機設定已存在。
package.json 為 1.4.174-rc.0；安裝與更新應依官方 stable channel 或 Releases 頁面判斷。
完成第一個三 agent 工作階段後，再依需求加入 CLI、自動化、Design Mode 或 SSH。每次只擴充一個執行面，並保留可重複的狀態檢查與 Git 驗收。
1. 註冊 Orca CLI。進入 Settings → General → Orca CLI，完成後執行 orca status --json。需要讓 agent 操作 Orca 時，再執行 npx skills add https://github.com/stablyai/orca --skill orca-cli。
2. 建立 SSH target。進入 Settings → SSH，新增主機、測試連線並儲存。建立 worktree 時將 Run on 改為該 SSH target。
3. 使用 Design Mode 修正 UI。在 Orca 瀏覽器開啟頁面，啟用 Design Mode 並點選目標元素。確認附件包含 HTML、computed CSS 與裁切畫面後，再描述修改要求。
4. 從原始碼參與開發。先閱讀 CONTRIBUTING.md。本手冊抓取時的開發引擎為 Node 24，package manager 為 pnpm 10.24.0；執行前以倉庫目前的 package.json 為準。
① Orca CLI overview：worktree、terminal、file 與 browser automation 指令入口。
② SSH worktrees：連線、遠端終端、檔案下載與 port forwarding。
③ CONTRIBUTING.md：原始碼開發與貢獻規範。