返回现场笔记
6 分钟阅读

同时跑着好几个 Agent 之后,我用 Orca 来管理了

把跑在电脑上的 Claude Code、Codex、OMP 等 Agent 统一收进 Orca 管理:手机远程控制、多项目多机器批量管理、可视化定时任务,以及桌面端与移动端的安装配置过程。

  • #orca
  • #ai-agent
  • #tooling
分散在多个终端的 Claude Code、Codex、OMP 等 Agent 被 Orca 统一收口管理
Claude CodeCodexOMPOrcaunified control
散落的 Agent 终端收进 Orca 统一管理

我最近把越来越多的活交给了跑在电脑上的 Agent,但随着 Agent 增加,不论是打开多个 Terminal 还是多开 VS Code,找到对应的项目指挥 Agent 干活都开始变得复杂起来了。

Orca 桌面端主界面

于是我在网上搜到了 Orca,这是一个 Agent IDE(官方叫法是 the worktree IDE for AI coding agents),可以在这个应用里运行 Claude Code、Codex、OpenCode、OMP 等等 Agent 软件,并且统一管理它们的运行状态。它在 GitHub 上有 4 万多 star,MIT 协议开源,是 YC 投资的一个团队开发的。

我对 Orca 的需求主要是在以下三点:

  • 可以在手机上远程控制电脑上的 Agent 工作。
  • 可以同时批量管理不同文件夹下多个 Agent 的工作情况。
  • 可视化的定时任务配置,帮我定时完成一些重复性的工作。

0. 安装 Orca

Orca 支持 macOS、Windows、Linux 三个平台,直接在官网下载:

https://www.onorca.dev/

  • macOS:分 Apple Silicon 和 Intel 两个版本
  • Windows:安装包
  • Linux:AppImage 或 .deb

旧版本可以去 GitHub Releases 页面找。

macOS 上也可以用 Homebrew 安装,官方发布了 cask,每次稳定版发布都会自动跟进:

brew install --cask stablyai/orca/orca

之后用 brew upgrade --cask orca 升级即可。注意 cask 跟的是 stable 通道——想体验 RC 版,得从 GitHub Releases 下载,或者走下面说的应用内更新。

首次启动

第一次打开 Orca,它会:

  1. 请求访问用户主目录的权限,用来添加仓库。
  2. 检测到 ~/.claude~/.codex 或 Ghostty 终端配置时,会提议导入。
  3. 最后停在一个空的起始页,在这里添加你的第一个仓库。

任意版本也都可以直接从 GitHub Releases 页面下载。

1. 可以在手机上远程控制电脑上的 Agent 工作

安装 Orca 移动端

这个功能比我预期的还要好用一些,可以非常丝滑地在手机上操控电脑上的 Agent。

手机端操控电脑上的 Agent

首先可以在移动端下载 Orca 软件:

配对也很简单:在电脑上安装完 Orca 之后,在左侧栏中选择 Orca 手机端,打开配对流程生成一个一次性配对码,手机端输入(或者在 APP 上扫码)就行。前提是手机和电脑之间有网络通路——同一个局域网,或者走 Tailscale(关于 Tailscale 如何设置可以看之前的 blog)。

电脑端生成配对码,手机扫码配对

手机端配对完成

完成配置之后就可以在手机上控制电脑上的 Agent 干活了。

装上之后能干什么:

  • 看所有 worktree 和 Agent 的状态(working / done / 等你输入),多台主机的列表会合在一个视图里。
  • 翻终端记录,看 Agent 干了什么、问了什么。
  • Agent 等你确认时,直接回 "continue"、"yes" 或者随便打一段字,也可以语音输入、发图片。
  • Agent 干完活收推送通知
  • 轻量的 Source Control:看改动、stage、提交,小修改在手机上就收尾了。
  • 从手机上直接创建新工作区,任务来源支持 GitHub、Linear、GitLab。

官方对移动端的定位:手机端不是完整的编辑器,是桌面端的遥控器

2. 多 Agent、多文件夹、多机器管理

随着使用 Agent 越来越多,现在本地已经有了相当多的 Agent 工作目录,不论是使用 Terminal 还是使用编辑器进行这些 Agent 管理已经变得相当繁琐。所以我亟需 Orca 这样的 Agent 管理软件。

Orca 支持自动检测出电脑上这些 Agent 软件(Claude Code、Codex、OMP、Kimi Code 等等)。

Orca 自动检测已安装的 Agent

同时 Orca 支持导入多个 Agent 工作目录,我们可以:

  • 按项目分组:一个项目对应一个 git 仓库(或一个文件夹),下面挂着这个项目的所有 worktree。常用的可以置顶,不看的可以按条件过滤。
  • 多仓库项目组:往 Orca 里添加一个包含多个 git 仓库的父文件夹,可以把它们归成一个 project group,还能在组级别创建"文件夹工作区",任务来源绑定到组内某个具体仓库。
  • 不止本机:创建 worktree 时可以选择 "Run on",把任务跑在别的机器上。

运行方式官方列了四种:

模式文件和 Agent 在哪适合场景
Local你自己的电脑日常开发,快速迭代
SSH target你通过 SSH 连接的远程主机家里/公司有台性能更强的机器,或 GPU 主机
Remote Orca Server一台跑着 Orca 的常驻机器笔记本合盖 Agent 也不断线,手机随时连
Cloud VM每个 worktree 一个一次性云沙箱任务级隔离,用完即毁

多个 Agent 并行运行

我自己的用法是第三种的简化版:Orca 跑在家里的电脑上常开,配上上一篇讲的 Tailscale,人在外面也能接管。设置上就是在服务端生成一个 access link,客户端粘贴添加,不需要 orca serve 命令行那套。

3. 定时任务

定时任务解决可以配置一些重复性的工作:到点自动派一个 Agent 去干活。这个功能在 Orca 里的左侧栏里。

定时任务列表和详情

列表页能看到每个任务的日程和下次运行时间,点进详情页可以看到:

  • 上次运行时间
  • token 用量
  • 累计执行次数

右上角有"立即运行"按钮,可以手动触发一次,方便调试。

编辑定时任务

新建或编辑任务,所有配置都收在一个对话框里:

  • 提示词:任务内容本身,定时任务不只是定时发一句话,可以把一整套现成的工作流挂上去。
  • 工作区:二选一。"工作树"是在已有的 worktree 里跑(图里选的 x-agent),"新运行"是每次新开一个。需要上下文累积的选前者,一次性任务选后者更干净。
  • 会话:新鲜的 / 重复利用。"重复利用"是多次运行复用同一个会话(详情页里显示 Reuse live session),上下文不断;上次的终端如果已经不在了,会自动退回新会话。
  • 智能体:执行任务的 Agent,图里配的是 OMP。
  • 日程:Daily、Weekdays 这类预设都有。更复杂的时间表可以走 Orca CLI 的 orca automations create,支持 cron 表达式和 RRULE。
  • 宽限期:图里配了 24 小时。官方同样没有细说,我的理解是"补跑窗口"——到点时电脑在睡眠或没开机,只要在这个窗口内醒过来就补跑一次。对凌晨 2 点这种任务,这个设置很关键。

配好之后建议先点"立即运行"手动验证一次,再交给日程自动跑。

定时任务到点:时钟触发,一颗任务包派发到 worktree,Agent 启动执行
schedulex-agentagent running…
到点触发派一个 Agentworktree 启动执行

结尾

Orca 完美地满足了我的三个需求:在手机上远程控制电脑上的 Agent 工作、批量管理不同文件夹下多个 Agent 的工作情况、以及通过配置定时任务,帮我完成一些重复性的工作。

非常合适我们个人平时的高频地使用 Agent。