Orca CLI
一、用途
Orca CLI 是一个公开命令行工具，用于操作由 Orca 管理的各类资源，包括工作树（worktree）、文件夹上下文、终端、仓库、自动化、产物、工作树评论，以及 Orca 应用内嵌的浏览器。它适用于当 Orca 正在运行的编辑器或运行时本身就是事实来源的场景。典型触发场景包括：Orca 工作树操作、子工作树、在工作树中派生 codex/claude、读取/等待/发送 Orca 终端内容、完整交接（full handoff / handover / give this to another agent），以及控制 Orca 内部浏览器。当 Orca 的状态并不重要时，应改用普通 shell 工具。
二、主要能力
根据资料，Orca CLI 覆盖以下对象：Orca 管理的工作树、文件夹上下文、终端、仓库、自动化、产物、工作树评论，以及 Orca 应用内置浏览器。该文件本身是“发现用的占位存根”，并非使用指南；完整的、与版本匹配的 Orca CLI 参考由 orca 二进制自身提供，这样它永远不会与真正执行命令的二进制发生漂移。
三、使用方式
- 为本会话解析 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 启动），面向智能体的调用优先使用 --json。
-
若旧版 Orca 不认识 skills get：仅当所选二进制明确报告 skills get 是未知命令时，才使用以下回退方案。其他失败不能证明是旧版二进制；应如实报告，而不是猜测或更换可执行文件。对于已确认是提供指南之前的旧版二进制，仅使用以下受限的只读引导命令来定位方向，不要卡死，也不要臆造命令： ORCA status --json ORCA worktree ps --json ORCA terminal list --json 然后告知用户：更新 Orca 即可通过 ORCA skills get orca-cli 恢复完整的、与版本匹配的指南。除这些命令之外，请询问用户，而不是猜测这个旧版二进制可能不支持的命令面。
四、适用场景与限制
适用场景：需要以 Orca 运行中的编辑器/运行时为事实来源时，例如管理工作树、在子工作树中派生 agent、读写 Orca 终端、执行完整交接、控制 Orca 内置浏览器。
限制：本文件只是发现存根，不包含完整命令参考；命令与参数随版本变化，必须通过 ORCA skills get orca-cli 获取与版本匹配的指南。在 Orca 管理终端之外的 Linux 上不得直接运行裸 orca，以免触发 GNOME 屏幕阅读器。所选可执行文件失败时应停止并报告，不应回退到其他可执行文件。旧版二进制的回退命令仅限于上述只读引导命令。资料未提供具体的子命令清单、价格或收费信息。