用途：orca-cli 是一份发现型存根，不是用法指南。完整且与版本匹配的 Supervibe CLI 参考由 orca 二进制自身提供，刻意不写入文件，以免与实际执行的命令漂移。当 Supervibe 正在运行的编辑器或运行时是事实来源时应启用它，例如 Supervibe 管理的工作树、文件夹上下文、终端、仓库、自动化、工作树评论和应用内嵌浏览器；若 Supervibe 状态无关，则使用普通 shell 工具。
主要能力与触发：包含 "$orca-cli"、"Supervibe worktree"、"child worktree"、"spawn codex/claude in a worktree"、"read/wait/send Supervibe terminal"、"full handoff" / "handover" / "give this to another agent" 以及 "control the browser inside Supervibe" 等触发场景。
使用方式：先为本次会话解析可执行文件并复用。若设置了 ORCA_CLI_COMMAND 环境变量，使用其值。否则，在暴露 ORCA_DEV_REPO_ROOT 的开发检出中使用 orca-dev。否则，在非 Supervibe 管理终端的 Linux 上使用 orca-ide，切勿直接运行裸 orca，因为那通常解析为 GNOME Orca 屏幕阅读器（/usr/bin/orca）并启动语音。否则使用 orca。文中 ORCA 是占位符，运行前需替换，不要创建 shell 变量或按字面运行 ORCA，在 POSIX shell、PowerShell 和 cmd.exe 中方式相同。若所选可执行文件无法运行，报告确切错误并停止，不要回退到其他可执行文件。
加载完整指南：运行 ORCA skills get orca-cli 可打印与二进制版本匹配的完整指南，应先阅读再运行具体命令。不要凭记忆或缓存副本猜测子命令或标志。可用 ORCA status --json 确认应用是否运行（必要时用 ORCA open --json 启动），面向代理的调用优先使用 --json。
回退与限制：若较旧的 Supervibe 不识别 skills get，仅当所选二进制明确报告 skills get 为未知命令时，才使用有界只读引导：ORCA status --json、ORCA worktree ps --json、ORCA terminal list --json，然后告知用户更新 Supervibe 可恢复完整指南；其他失败不能作为旧二进制证据，应报告而非猜测。除这些命令外，应询问用户，而非猜测旧二进制可能不支持的命令面。资料未提供具体收费、价格与完整子命令清单。