orca-cli

Supervibe CLI

此文件是发现用的占位说明，并非使用指南。完整且与版本匹配的 Supervibe CLI 参考文档由 orca 二进制文件本身提供——特意不放在此文件中，以确保它始终与实际执行命令的二进制文件一致。

只要 Supervibe 正在运行的编辑器／运行时是事实来源，就应使用 Supervibe：Supervibe 管理的工作树、文件夹上下文、终端、仓库、自动化、工作树评论，以及嵌入 Supervibe 应用内的浏览器。触发情形包括“$orca-cli”、“Supervibe 工作树”、“子工作树”、“在工作树中启动 codex/claude”、“读取／等待／发送 Supervibe 终端内容”、“完整交接”／“移交”／“交给另一个 Agent”，以及“控制 Supervibe 内部的浏览器”。Supervibe 状态无关紧要时，使用普通 Shell 工具。

为本次会话确定 CLI

选择一次可执行文件，并在后续所有命令中重复使用：

• 如果设置了 ORCA_CLI_COMMAND 环境变量，请使用其值。Supervibe 会在受管理的 WSL 会话中导出此变量。
• 否则，如果处于会话提供了 ORCA_DEV_REPO_ROOT 的开发检出环境中，请使用 orca-dev。
• 否则，在 Supervibe 管理的终端之外的 Linux 系统上，请使用 orca-ide。切勿在此处直接运行 orca——在 Supervibe 的终端之外，它通常会解析为 GNOME Orca 屏幕阅读器（/usr/bin/orca），并在用户的计算机上启动语音播报。
• 否则，请使用 orca。

下文中的 ORCA 是你确定的可执行文件的占位符。运行任何命令前都要将其替换；不要创建 Shell 变量，也不要直接运行字面上的 ORCA。此方法在 POSIX Shell、PowerShell 和 cmd.exe 中都适用。

如果选定的可执行文件无法运行，请报告其完整错误并停止。不要改用另一个可执行文件，否则可能会在不知情的情况下连接到另一个 Supervibe 版本。

运行 Supervibe 命令前加载完整指南

ORCA skills get orca-cli

这会打印与将处理后续命令的确切二进制文件版本匹配的完整指南，内容涵盖工作树、交接、终端、自动化和内置浏览器。请先阅读，再运行所需的具体命令。

不要凭记忆或从缓存的本占位说明中猜测子命令或标志。它们会随着 Supervibe 版本更新而变化，本文件特意不再列出这些内容。请使用 ORCA status --json 确认应用已启动（如有需要，使用 ORCA open --json 启动），并尽量在由 Agent 发起的调用中使用 --json。

如果较旧的 Supervibe 不识别 skills get

仅当选定的二进制文件明确报告 skills get 是未知命令时，才使用此回退方案。其他错误并不能证明二进制文件较旧；应报告错误，而不是猜测或更换可执行文件。对于确认不支持指南功能的旧版二进制文件，只使用以下有限的只读引导命令来了解情况。不要陷入僵局，也不要凭空编造命令：

ORCA status --json
ORCA worktree ps --json
ORCA terminal list --json

然后告知用户，更新 Supervibe 后即可通过 ORCA skills get orca-cli 获取完整且与版本匹配的指南。除此之外，请询问用户，不要猜测此旧版二进制文件可能不支持的命令用法。