用途：Orca CLI 用于在 Orca 的编辑器/运行时作为事实来源时操作其管理的资源，包括工作树、文件夹上下文、终端、仓库、自动化、工件、工作树评论，以及 Orca 应用内置的浏览器。典型触发场景有 Orca 工作树、子工作树、在工作树中启动 codex/claude、读写或等待 Orca 终端、代理交接，以及控制 Orca 内置浏览器；若 Orca 状态无关，则用普通 shell 工具。
使用方式：先确定本次会话要用的可执行文件并复用。若设置了 ORCA_CLI_COMMAND 环境变量，用其值；否则在暴露 ORCA_DEV_REPO_ROOT 的开发检出中使用 orca-dev；否则在 Orca 管理终端之外的 Linux 上用 orca-ide，注意不要在那里直接运行裸 orca，它通常指向 GNOME Orca 屏幕阅读器（/usr/bin/orca）并会在用户机器上开始朗读；其余情况用 orca。文中 ORCA 是可执行文件占位符，运行前要替换，不要创建 shell 变量或直接运行 ORCA；该方式在 POSIX shell、PowerShell 和 cmd.exe 中一致。若所选可执行文件无法运行，报告其确切错误并停止，不要降级到其他可执行文件。
获取完整指南：运行 ORCA skills get orca-cli，会打印与即将处理命令的确切二进制版本匹配的完整指南，涵盖工作树、交接、终端、自动化和内置浏览器。先读它，再运行具体命令。不要凭记忆或本缓存猜测子命令与参数；它们会随 Orca 版本变化。可用 ORCA status --json 确认应用已启动（必要时用 ORCA open --json 启动），面向代理的调用优先使用 --json。
旧版回退：仅当所选二进制明确报告 skills get 是未知命令时使用回退；其他失败不算旧版证明，应报告而非猜测或更换可执行文件。对确认的旧版二进制，只可用以下只读、有限的引导命令：ORCA status --json、ORCA worktree ps --json、ORCA terminal list --json。然后告知用户更新 Orca 可恢复通过 ORCA skills get orca-cli 获取的完整版本匹配指南。除此之外，应询问用户，不要猜测该旧版可能不支持的命令面。