orca-cli

Orca CLI

此文件是发现用的存根，并非使用指南。完整且与版本匹配的 Orca CLI 参考文档由 orca 二进制程序本身提供——特意不放在此文件中，以确保它不会与实际运行并处理命令的二进制程序出现偏差。

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

为本次会话确定 CLI

选择一次可执行程序，并在之后的每条命令中重复使用：

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

下文中，ORCA 是你确定的可执行程序的占位符。运行任何命令之前，请将其替换为实际程序；不要创建 shell 变量，也不要直接运行 ORCA。这在 POSIX shell、PowerShell 和 cmd.exe 中的用法相同。

如果所选可执行程序无法运行，请报告其确切错误并停止。不要改用其他可执行程序，否则可能会悄悄指向另一个 Orca 版本。

运行 Orca 命令前先加载完整指南

ORCA skills get orca-cli

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

不要凭记忆或缓存的存根副本猜测子命令或标志。它们会随 Orca 版本变化，此文件也已特意不再列出这些内容。使用 ORCA status --json 确认应用已启动（如有需要，使用 ORCA open --json 启动），并在由 Agent 驱动的调用中优先使用 --json。

如果较旧的 Orca 不识别 skills get

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

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

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