Orca 如何用 Agent Feed 统一查看所有 worktree 的 Agent 完成与阻塞事件
【免费下载链接】orcaOrca is the ADE for working with a fleet of parallel agents. Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.项目地址: https://gitcode.com/GitHub_Trending/orca48/orca
在 Orca 里并行跑多个 coding agent 时,任务分散在不同 worktree 中,逐个切过去看哪个完成了、哪个在等输入,是典型的低效操作。Orca 的侧边栏提供了一个Agents入口,打开后是所有 worktree 的 agent 事件线程式信息流(Agent Feed):完成、阻塞提问、未读状态和 worktree 创建事件都集中在一个按时间排列的界面上做 triage。它默认开启,不替代头部铃铛和系统通知,而是你离开 Orca 一段时间回来之后的"追进度"表面。
前提:让 Agent 状态可被识别
Feed 里能看到什么,取决于 Orca 能否识别终端里跑的是哪个 agent。状态检测来自终端的 OSC title 序列和 agent hooks,Claude Code、Codex 及若干其他 agent 会发出这些信号。因此准备步骤是:
- 侧边栏Add Repo,指向一个本地 checkout。Orca 读取 git 状态并把默认分支作为base ref——新 worktree 从它分出。
- 点击仓库名旁的+创建 worktree,输入任务名(留空时 Orca 会自动命名),选择 start-from ref(多数情况就是 base ref,如
origin/main),提交后git fetch和git worktree add在后台执行,新 worktree 带进度行出现在侧边栏,checkout 完成后切到终端。 - 在新 worktree 的终端里通过agent combobox选择 agent(Claude Code、Codex、Cursor CLI 等)启动。不要直接手敲 CLI 二进制名——Agents & sessions 文档明确说明:如果看不到状态指示符,通常就是该会话里的 agent CLI 不是 Orca 能识别的,应通过 combobox 启动。
创建多个 worktree、各自启动一个 agent 后,Feed 才会出现多条值得 triage 的线程。
在 Feed 中查看完成与阻塞事件
点击侧边栏的Agents入口打开 Feed。每条 entry 是以下之一:
- 一个 agent 结束了一轮(turn),处于 idle 或被某个问题阻塞;
- 一个新 worktree 被创建;
- 一个等待输入超过阈值、被标记为 blocking 的 agent;
- agent 最近一次回复的简短预览——不用打开每个线程也能快速扫一眼。
线程按状态分组:仍在 working 的 agent 固定钉在顶部,方便一眼看出哪些还在干活。
操作上的几个要点:
- 未读徽标:自上次访问后有新事件到达时,Agents 入口显示 unread badge。
- 跳转:点击一条 entry 会跳到对应的 worktree 和 pane——与 Orca 从系统通知跳转的交接方式相同。
- 过滤器快捷键:macOS 用
Cmd+F,Windows 和 Linux 用Ctrl+F聚焦 feed 过滤器。注意:当内嵌终端持有焦点时,同一快捷键会留在终端里,过滤器不会获得焦点。
Feed 与通知的分工是明确的:agent 从 working 转到 idle 时,Orca 仍会照旧发出系统通知、声音和 worktree 上的 chip(见 Notifications & Inbox);头部铃铛聚合所有 worktree 的未读通知,macOS 上还会镜像为 Dock 图标徽标。Feed 不替代这些,它解决的是"回来之后一次性看清全部变化"的问题,而不是实时提醒。
判断 Agent 当前处于哪种状态
Feed 里的完成与阻塞事件,对应的是各 worktree 上共享的状态符号,识别后可交叉验证:
- Spinner — working(工作中)
- 琥珀色问号 — 在等你的输入(权限请求 / 需要回答);侧边栏 "Needs You" 计数用同一符号
- 绿色对勾(dashboard)/ 绿点(侧边栏)— 完成 / 静默活跃
- 红点 — blocked、被打断或失败
- 灰点 — idle
- 无指示符 — 普通 shell,不是被识别的 agent CLI
会话生命周期为:Launch(combobox 选 agent,Orca 拉起 CLI)→ Work(OSC title 更新状态)→ Idle(Orca 检测到 working→idle 转换并触发 agent-finished 通知)→ Exit(进程结束,tab 上出现 Restart chip)。所以一条"完成"事件对应的正是 working→idle 这次转换,而"阻塞"事件对应琥珀色问号状态。
可选分支:用 Agent Dashboard 看板视图
如果你更习惯分列看板而不是时间线,可以在Settings → Experimental → Agent Dashboard打开一个跨 worktree 的 agent 看板:左栏Needs You(等权限或提问)、Working(在跑)、Done(已完成、可能还需 review)、Idle(约 30 分钟未上报完成,默认在面板上隐藏,需在面板的 board settings 齿轮里打开Show idle agents)。看板上可以为Toggle Agent Dashboard绑定快捷键(默认无绑定,需在 Settings → Shortcuts 里配置)。这是 Feed 之外的替代视图,同一批状态信号,两种呈现方式。
验证方式与限制
按上面的前提完成后,成功条件是:侧边栏 Agents 入口存在且默认开启;各 worktree 的 agent tab 上出现状态符号(spinner / 问号 / 绿点 / 红点);当有 agent 完成或阻塞时,Feed 出现对应 entry,入口出现 unread badge;点击 entry 能落到正确的 worktree 和 pane。
需要注意的边界:
- 状态只对被 Orca 识别的 agent CLI 生效;直接手敲二进制启动的会话没有指示符,也不会在 Feed 里呈现有效的完成/阻塞事件。
Cmd+F/Ctrl+F在终端聚焦时属于终端,不聚焦 feed 过滤器。- Feed 是 catch-up 表面:agent-finished 的实时提醒仍由系统通知和头部铃铛负责,Feed 不改变这一行为;具体分类的开关在 Settings → Notifications 里调整。
相关文档
- Agents feed
- Notifications & Inbox
- Agents & sessions
- Worktrees
【免费下载链接】orcaOrca is the ADE for working with a fleet of parallel agents. Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.项目地址: https://gitcode.com/GitHub_Trending/orca48/orca
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考