平行 Agent 的 Worktree 工作介面
\n\n
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。
Create
Work
Review
Ship
Archive / Delete
“Each worktree has its own branch, its own files on disk, and its own agent terminals.”
安裝 Orca 與 CLI 驗證
從 Orca 官方下載頁選擇 macOS、Windows 或 Linux 安裝檔。macOS 也可使用 Homebrew；Arch Linux 可從 AUR 安裝。
brew install --cask stablyai/orca/orcaArch Linux 安裝
使用 AUR binary package；若要選擇其他平台或歷史版本，改從官方下載頁或 GitHub Releases 取得安裝檔。
yay -S stably-orca-bin從平行執行到差異審查
Orca 將多 agent 執行、程式碼審查與遠端工作區放在同一個產品模型中。先依任務的隔離需求建立 worktree，再選擇終端、瀏覽器、行動端或 SSH 功能。
Execute · 01
Parallel Worktrees
隔離的 Git 工作區
將同一個提示分派到多個 agent；每個 agent 使用獨立分支與檔案。
Observe · 02
Terminal Splits
多終端 並排監看
在分割窗格中查看多個 agent；終端 scrollback 可跨應用程式重新啟動保留。
Review · 03
Annotate AI Diff
行內 批次意見
在 agent 產生的 diff 行上留下註解，再將整批意見送回指定 agent 修正。
Design · 04
Design Mode
畫面元素的 程式碼脈絡
點選瀏覽器中的元素，傳送 HTML、computed CSS、裁切畫面與可用的來源位置。
Remote · 05
SSH Worktrees
遠端 運算環境
在 SSH 主機建立 worktree 與執行 agent，同時在本機保留編輯器、diff 與狀態介面。
Mobile · 06
Mobile Companion
行動端 監看與追問
從手機查看 agent 狀態、接收完成通知，並傳送後續指示。
Integrate · 07
GitHub & Linear
任務與 審查整合
在應用程式內瀏覽 PR、issue 與專案項目，並從工作項目建立 worktree。
Automate · 08
Orca CLI
工作區 自動化介面
從 shell 管理 worktree、agent terminals、檔案、內建瀏覽器與排程自動化。
功能選用表
| 任務 | 使用功能 | 可觀察結果 |
|---|---|---|
| 比較多個 agent 的同題實作 | Parallel Worktrees | 每個方案位於獨立分支與 diff |
| 修正瀏覽器中的 UI 元素 | Design Mode | agent 收到 DOM、樣式與裁切畫面 |
| 在遠端主機執行長時間任務 | SSH Worktrees | agent 在遠端執行，本機顯示編輯器與 diff |
| 將多個行內意見送回 agent | Annotate AI Diff | 註解以單一批次進入修正回合 |
Worktree 的操作原則
平行執行依賴工作目錄隔離、明確的共享檔案策略與人工審查。以下規則均來自 Orca 官方文件。
原則 · 每項任務使用獨立 Worktree
從明確的 base ref 建立 worktree。比較完成後，保留被選取的分支；刪除其他 worktree 前先確認其中沒有需要保留的提交。
來源 · Orca Docs / Worktrees
原則 · 明確設定共享與複製路徑
新 worktree 不包含 gitignored dependencies、cache 與 secrets。大型可重建目錄使用 Shared Paths 或 worktree.sharedDirectories；需要獨立副本的設定使用 .worktreeinclude。
來源 · Orca Docs / Worktrees
原則 · 將審查意見合併成批次
先在 diff 中完成行內註解，再使用 Send to agent 一次送出。agent 修正後保留原註解，逐項確認並標記 Resolve。
來源 · Orca Docs / Annotate AI Diff
原則 · 先決定遙測設定
封裝版應用程式會傳送匿名產品使用事件。若政策要求停用，請在 Settings → Privacy 關閉，或設定 DO_NOT_TRACK=1、ORCA_TELEMETRY_DISABLED=1。
來源 · Orca Docs / Privacy & Telemetry
三個 Agent 的同題比較
以下流程依官方「Your first 3-agent session」整理。目標是讓三個 agent 從相同 base ref 處理同一項任務，再以 diff 與測試結果選擇保留的實作。
$ Operator ›
Add Repo → 選擇本機 checkout
$ Operator ›
建立三個 worktree，start-from 均選 origin/main
fix-login-race → Claude Code
fix-login-race-2 → Codex
fix-login-race-3 → Cursor CLI
$ Operator ›
將同一份登入競態修正需求送給三個 agent
claude: Orca ›
三個 worktree 各自產生分支、終端與 diff。
$ Operator ›
開啟分割窗格監看狀態；完成後逐一開啟 diff。
$ Operator ›
在候選 diff 上加入行內註解 → Send to agent
ok: [Review comments resolved · checks reviewed]
$ Operator ›
在 Orca 提交並推送選定分支；刪除其餘 worktree 前確認無需保留的提交。
$ Terminal › command -v orca
$ Terminal › orca status --json
“Three branches. Three diffs. Same prompt.”
驗收條件
每個候選方案必須保有獨立 diff 與測試證據。選擇結果後，先確認修正意見已處理，再提交被選取的分支；未被採用的 worktree 不得含有未保存的提交。
平行工作區的驗收條件
從桌面工作區到自動化與遠端執行
完成第一個三 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：原始碼開發與貢獻規範。
“If it runs in a terminal, it runs in Orca.”
\n\n