mirror of
https://github.com/stablyai/orca.git
synced 2026-09-27 16:02:35 +00:00
Neil
90801e2deb
* feat(agents): add first-class ZCode harness Add ZCode (Z.ai's `zcode` CLI) as a supervised Orca agent: managed lifecycle hooks on local, SSH and Windows hosts; status, question and approval reporting; synthetic status titles; session resume; orchestration worker launch options; and desktop + mobile agent-picker registration. Written against the newly open-sourced `zai-org/ZCode` (agent CLI 0.16.9), not against a remembered screen: - ZCode's hook runner writes a Claude-compatible stdin alias set, so it routes through the existing Claude-compatible vendor path while keeping its own identity in the sidebar. - `PermissionRequest` fires only once the approval card is on screen and racing the user's answer, so it is proof the pane is blocked, not an auto-approval. - ZCode's clarification tool is literally `AskUserQuestion` with Claude's questions/options shape, so Orca's question card renders it unchanged. - ZCode's `hooks.enabled` defaults to false, which is why configured hooks were reported as never firing; the installer sets it. - ZCode renames its own process to `zcode-cli`, so the expected foreground process cannot be the launch command or dispatch refuses the pane. - ZCode emits no OSC title in any state and repaints its ASCII banner forever, so readiness comes from Orca's synthetic hook title and launch drafts wait on the composer box rather than on a quiet render window. Three files crossed their max-lines limit, so each is split along a real seam: command-line entrypoint parsing out of agent process recognition, skill classification out of skill root discovery, and registry coverage out of the remote hook installer tests. Refs #10564 * fix(zcode): drop the session-option catalog and pin the orchestration contract ZCode's CLI exposes no `--model` flag at all, and the session-option launch path refuses to apply any option until a model id is chosen. A catalog therefore could not deliver `--mode` per worker, and would have accepted `--model` only to drop it silently. Take opencode's position instead: no catalog, so `worker-start --model` is refused with a clear message and ZCode launches with the model from its own config. `--mode` stays reachable through agent args, which is also how the yolo default is applied. Add a contract test covering the parts that make ZCode a usable worker: dispatchable foreground process, stdin prompt delivery, the prompt staying out of the launch command, and the composer-gated draft paste. * refactor(zcode): reuse shared helpers and cut the harness down No behaviour change; every ZCode test still passes. - Use installer-utils' own `hookDefinitionHasManagedCommand` instead of re-walking a hook definition by hand, which also drops a local string reader. - Share one `readZCodeEventMap` instead of keeping the same narrowing in both hook-settings and hook-config-json. - Collapse five identical error returns into one `zcodeHookError` builder, and return early from the status branches instead of assigning through `let`. - Split the event-to-status decision out of `normalizeZCodeEvent` into a pure `readZCodeTurn`, so the normalizer reads as decide-then-build and stops computing the tool name for events that never look at it. - Take a script file name in `readManagedZCodeHookEvents` like its siblings, which removes a `Parameters<typeof …>` indirection at the call site. - Drop the unused `ZCodeHookEvent` export and inline a single-use path helper. - Correct a stale comment: ZCode's loader is a strict `JSON.parse`, so the in-place edit preserves key order and indentation, not comments. * fix(zcode): address review — keep unmanaged event keys, correct comment, de-dupe README - `removeZCodeManagedHooks` deleted any event key whose list ended up empty, so an unrelated `"Notification": []` the user wrote was removed as collateral whenever a managed hook elsewhere made the write happen. Only touch an event Orca actually owned something in; covered by a new regression test. - The `isNewTurnEvent` comment claimed UserPromptSubmit was ZCode's only turn boundary while the expression below it also returned true for SessionStart. Say what the code does: SessionStart lands the idle boundary, UserPromptSubmit is the turn boundary (the Codex/Claude shape). - ZCode appeared twice in the README's single agent-badge block; keep the local-icon entry the link checker validates and drop the favicon duplicate. * docs(zcode): call out that the desktop bundle's CLI cannot open a session From live testing on #22464: pointing `zcode` at the desktop app's bundled `glm/zcode.cjs` installs Orca's hooks fine but then fails with `Cannot find package '@zcode/tui'`, so the pane never opens a session. The symptom reads as a broken harness when the CLI simply has no TUI. Say which build to use and how to check before reporting a problem. Reported-by: JWu527
Orca
English · 日本語 · 한국어 · Español · Français · Português
面向 100x 构建者的 AI 编排器。
并排运行 Codex、Claude Code、OpenCode 或 Pi — 每个都在自己的 worktree 中运行，并在一个地方统一跟踪。
下载 Orca
特性
移动 Companion 应用用手机监控并指挥你的智能体 — 智能体完成时收到通知，随时随地发送后续指令。 |
 |
并行 Worktree把一个提示同时分发给五个智能体，每个都在自己隔离的 git worktree 中运行 — 比较结果，合并最佳方案。 |
 |
终端分屏Ghostty 级终端，支持 WebGL 渲染、无限分屏，以及重启后依然保留的滚动历史。 |
 |
设计模式在真实的 Chromium 窗口中点击任意 UI 元素，把它的 HTML、CSS 和裁剪好的截图直接发送到智能体的提示中。 |
 |
GitHub & Linear 原生集成在应用内浏览 PR、issue 和项目看板 — 从任意任务打开 worktree，无需切换上下文即可完成评审。 |
 |
SSH Worktree在高性能远程机器上运行智能体，完整支持文件编辑、git 和终端 — 自动重连与端口转发一应俱全。 |
 |
标注 AI Diff在任意 diff 行上添加评论并发回给智能体 — 评审、编辑、提交，全程无需离开 Orca。 |
 |
拖文件给智能体VS Code 的编辑器，处处自动保存 — 把文件或图片直接拖入智能体提示。 |
 |
Orca CLI智能体也能驱动 Orca — 用 |
 |
开箱即用的还有：
- 快速打开 — 在 worktree、文件、智能体、命令和仓库上下文之间搜索，不打断你的心流。
- 账号切换与用量追踪 — 查看 Claude 和 Codex 的用量与限额重置时间，并且无需重新登录即可热切换账号。
- 丰富仓库预览 — 在工作区中预览 Markdown、图片、PDF 和仓库文档。
- Computer Use — 当工作流需要真实交互时，让智能体操作桌面应用和可见 UI。
- 通知与未读状态 — 第一时间知道智能体何时完成或需要关注，并可将会话标记为未读，稍后再回来处理。
- 还有很多很多 — 我们每天发布新功能，这个列表永远跟不上。更新日志才是真正的功能列表。
支持的智能体
适配任何 CLI 智能体 — 只要能在终端里运行，就能在 Orca 里运行。
Claude Code
Codex
Grok
Cursor
GitHub Copilot
Muse
ZCode
OpenCode
Amp
OpenClaude
Antigravity
Pi
oh-my-pi
Hermes Agent
Goose
Auggie
Autohand Code
Charm
Cline
Codebuff
Command Code
Continue
Droid
Kilocode
Kimi
Kiro
Mistral Vibe
Qwen Code
Rovo Dev
+ 任何 CLI 智能体
安装
桌面端 — macOS、Windows、Linux
- 从 onOrca.dev 下载
- 或直接获取安装包：macOS Apple Silicon · macOS Intel · Windows (.exe) · Linux AppImage · 全部构建
也可以通过包管理器安装：
# macOS (Homebrew)
brew install --cask stablyai/orca/orca
# Arch Linux (AUR) — or stably-orca-git to build from source
yay -S stably-orca-bin
移动 Companion 应用 — iOS、Android
与桌面应用配对，用手机监控并指挥你的智能体。
- iOS: 从 App Store 下载
- Android: 下载 APK
社区与支持
-
Discord: 加入 Discord 社区。
-
Twitter / X: 关注 @orca_build 获取更新和公告。
-
微信: 扫码加入 Orca 社区微信第 10 群。
-
反馈与想法: 我们发布很快。缺少什么功能？提交功能请求。
-
隐私: 查看隐私与遥测文档，了解 Orca 收集哪些匿名使用数据以及如何退出。
-
支持我们: 给这个仓库点 Star，关注我们的日常发布。
开发
想要贡献代码或在本地运行？请参阅我们的 CONTRIBUTING.md 指南。
许可证
Orca 是自由且开源的软件，遵循 MIT 许可证。