一句话理解:Orca 就是一个"AI 开发的 IDE"——你把 Claude Code、Codex、Cursor 等任意 CLI Agent 跑进它,Orca 帮你管理多 Agent 的并行 worktree、终端分屏、远程 SSH 和移动端监控。
读完本文你将了解:核心功能 | 架构设计 | 快速上手 | 实测效果 | 适用场景
🎯 这个项目解决什么问题?
2025-2026 年,AI 编程 Agent 呈现"百花齐放"的态势:Claude Code、OpenAI Codex、Cursor CLI、Pi、OpenCode……每个 Agent 各有特色,但开发者面临一个现实问题:
怎么让多个 Agent 同时工作?
- 跑一个 Agent 时,另一个 Agent 可能在另一个终端里卡住了,你不知道
- 想让两个 Agent 并行实现同一个功能的不同方案,然后比较结果——没有原生工具支持
- 人离开电脑时,Agent 跑完了没法通知你
- 想用远程服务器跑 Agent,又要折腾 SSH 端口转发、环境同步
Orca 的答案很简单:把这些 Agent 当成"工具人"塞进一个 IDE 里,统一编排。
它本质上是一个ADE(Agent Development Environment)——和传统 IDE 的区别在于,它管理的不是代码文件,而是 AI Agent 的运行生命周期。
🔧 快速上手(动手环节)
安装
# macOS(推荐)brewinstall--caskstablyai/orca/orca# 或者从官网下载# https://onorca.dev/download第一步:启动并配置 Agent
打开 Orca,界面左下方有一个Agent 配置区。点击「+」选择你要运行的 Agent:
# 以 Claude Code 为例claude# 以 Codex 为例codex# 以 OpenCode 为例opencodeOrca 会自动检测你本地已安装的 CLI Agent,你只需要选择即可。
第二步:用 Parallel Worktree 一次跑 5 个方案
这是 Orca 最核心的功能——并行 worktree。
# 在 Orca 的 Terminal 中执行orca worktree create--prompt"把这段代码用 React + TypeScript 重写"--agentclaude--copies5这会在同一个仓库下创建 5 个独立的 git worktree,每个 worktree 里各跑一个 Claude Code 实例,各自独立实现同一个需求。完成后你可以在 Orca 里逐个对比 diff,选择最优方案合并。
第三步:从手机监控 Agent 进度
安装 Orca 移动端:
- iOS: App Store 搜索 Orca IDE
- Android: GitHub Releases 下载 APK
扫码配对后,Agent 完成时会推送通知到你手机,你甚至可以直接在手机上输入 follow-up 指令。
第四步:远程 SSH Worktree
# 配置远程服务器orcasshadd--hostyour-server.com--userroot# 在远程跑 Agentorca worktree create--sshyour-server.com--prompt"优化这个查询性能"--agentcodexSSH worktree 自动处理端口转发、文件同步、断线重连——远程服务器上的 Agent 操作体验和本地一样流畅。
⚙️ 技术原理
核心架构:Electron + TypeScript
Orca 是典型的 Electron 桌面应用,前端用 React + TailwindCSS + shadcn/ui,后端 Node.js 进程管理 Agent 生命周期。
┌─────────────────────────────────────────────────────┐ │ Orca Desktop App │ │ ┌──────────────┐ ┌──────────────┐ ┌────────────┐ │ │ │ Agent 面板 │ │ Terminal │ │ Sidebar │ │ │ │ Claude Code │ │ Split 1 │ │ Git 面板 │ │ │ │ Codex │ │ Split 2 │ │ Diff 视图 │ │ │ │ OpenCode │ │ Split N │ │ Worktree │ │ │ └──────┬───────┘ └──────┬───────┘ └──────┬─────┘ │ │ │ │ │ │ │ ┌──────┴─────────────────┴──────────────────┴─────┐ │ │ │ Electron Main Process │ │ │ │ ┌──────────┐ ┌──────────┐ ┌───────────────┐ │ │ │ │ │ node-pty │ │ Watcher │ │ SSH Manager │ │ │ │ │ │ 终端模拟 │ │ 文件监控 │ │ 远程连接管理 │ │ │ │ │ └──────────┘ └──────────┘ └───────────────┘ │ │ │ └─────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────┘ │ ▼ ┌──────────────────────┐ │ Agent 进程(子进程) │ │ ┌────────┐ ┌────────┐│ │ │Claude │ │ Codex ││ ← 每个 Agent 独立运行 │ │Code │ │ ││ │ └────────┘ └────────┘│ └──────────────────────┘Worktree 机制
Orca 的 worktree 不是简单的git worktree封装——它做了三层抽象:
- git worktree 层:每个 Agent 拥有独立的 worktree,互不干扰
- 进程隔离层:每个 worktree 绑定一个 node-pty 终端进程,Agent 的输出流独立管理
- 生命周期层:Orca 监控每个 Agent 的 stdin/stdout/stderr,Agent 完成时触发通知
终端渲染:WebGL 加速
Orca 内置了基于 @xterm/xterm 的 WebGL 渲染终端,支持无限分屏、会话持久化(重启后恢复滚动缓存),在 60fps 下渲染大量日志输出也不卡顿。
移动端架构
移动端通过 WebSocket 与桌面端配对,桌面端运行一个轻量 relay 服务,转发 Agent 状态事件和输入输出。通信协议基于 JSON-RPC,传输层用 ws(桌面端)和原生 WebSocket(移动端)。
🏗️ 架构分析
模块划分
src/ ├── main/ ← Electron 主进程(窗口管理、IPC、Agent 生命周期) ├── renderer/ ← React 前端(UI、终端渲染、Diff 视图) ├── preload/ ← 预加载脚本(桥接主进程与渲染进程) ├── cli/ ← orca CLI 命令行入口 ├── relay/ ← 移动端配对中继服务 ├── shared/ ← 前后端共享类型和工具 └── skills/ ← 技能系统(编排、Linear 集成、计算机操作)关键技术栈
| 组件 | 技术选型 | 选型理由 |
|---|---|---|
| 桌面框架 | Electron 43 | 跨平台 + 原生能力(文件系统、子进程、系统通知) |
| 前端框架 | React 19 | 成熟生态,终端组件集成方便 |
| 构建工具 | electron-vite + Vite 7 | 开发体验好,HMR 快 |
| 终端模拟 | @xterm/xterm + node-pty | 业界标准,WebGL 渲染性能好 |
| 样式方案 | TailwindCSS 4 + shadcn/ui | 组件化、可定制 |
| 包管理器 | pnpm + workspace | 大型 monorepo 管理 |
| 语言 | TypeScript 7 | 类型安全 |
可扩展性设计
Orca 的 Skills 系统是一个值得关注的架构亮点。它通过预定义的 skill 脚本(在skills/目录下)扩展 Orca 的能力:
- orchestration/:Agent 编排逻辑(并行 worktree 创建、结果对比)
- computer-use/:计算机操作(让 Agent 操作桌面应用)
- linear-tickets/:Linear 项目集成(从 Issue 创建 worktree)
- orca-cli/:CLI 命令扩展
每个 skill 都是一个独立的模块,Orca 可以在运行时按需加载。这种插件化设计让 Orca 的能力边界可以无限扩展。
✅ 优缺点 & 适用场景
优势
- Agent 无关性:任何 CLI Agent 都能跑——Claude Code、Codex、OpenCode、Cursor CLI、Grok、Pi、甚至自己写的脚本,不绑定任何供应商
- Parallel Worktree 是真香:让 5 个 Agent 同时实现同一个功能,对比结果选最优,这比"一个人写、一个人 review"效率高太多了
- SSH 远程 Agent:本地 M 芯片开发,远程 A100 服务器跑计算密集型 Agent 任务,延迟≈本地
- 移动端监控:Agent 跑完手机上收到推送,直接回 follow-up——不用一直盯着电脑
- 开源 MIT:可以自部署、修改、二次开发
局限
- 学习曲线:worktree、SSH、skill 等概念需要时间消化,不是开箱即用的"装好就能飞"
- 资源消耗:跑 N 个 Agent 等于开了 N 个终端进程,16GB 内存的机器跑 5 个 Agent 并行会吃力
- 仅桌面端:没有纯 Web 版,VPS 场景需要 x11 forwarding 或 SSH 变通
- 部分功能有 Beta 感:Open Issues 超过 2300 个(虽然其中很多是 feature request),某些边界场景稳定性有待提升
- 缺少内置成本控制:多个 Agent 并行跑,API 费用可能意外飙升,Orca 不做调用量限制
适用场景
| 场景 | 推荐度 | 说明 |
|---|---|---|
| 多人团队多方案并行开发 | ⭐⭐⭐⭐⭐ | Parallel worktree 对比合并,效率翻倍 |
| 远程 GPU 服务器开发 | ⭐⭐⭐⭐⭐ | SSH worktree 天然适配 |
| 跨 Agent 能力对比选型 | ⭐⭐⭐⭐ | 同时跑 Claude Code 和 Codex 看谁更行 |
| 个人开发者日常 | ⭐⭐⭐ | 单 Agent 场景用 VSCode 插件更轻量 |
| 移动端快速 review | ⭐⭐⭐⭐ | 手机上看 Agent 进度 + 回复,适合摸鱼式开发 |
总结
Orca 解决了一个真实的痛点——AI Agent 越来越多,但没有一个工具把它们管起来。它把 Agent 从"临时启动的终端进程"升级为"IDE 中可编排的一等公民"。
如果你正在深度使用 AI 编程 Agent,尤其是需要在多个方案间并行探索、需要远程服务器跑 Agent、或者想用手机监控 Agent 进度,Orca 是目前唯一的选择。
下一步:下载 Orca,把平时用的 Agent 全部注册进去,然后试试orca worktree create --prompt "你的需求" --copies 3——你会发现自己再也不想回到单 Agent 时代了。
信息来源说明:
- ✅ 已验证:基于 GitHub README 和项目源码分析
- 📄 文档:来自 onorca.dev 官方文档
- 💡 推断:基于架构分析和经验判断