用途：当 Orca 正在运行的编辑器或运行时是操作对象的事实来源时，可用 Orca CLI 控制其管理的工作树、文件夹上下文、终端、仓库、自动化、工作树评论，以及 Orca 应用内嵌浏览器。触发场景包括 Orca 工作树、子工作树、在工作树中生成 codex/claude、读取/等待/发送 Orca 终端、完整交接给其他智能体，以及控制 Orca 内置浏览器。若 Orca 状态无关，则用普通 shell 工具。
使用方式：先为本会话选定一个可执行文件并全程复用。若设置了 ORCA_CLI_COMMAND 环境变量，使用其值；否则在暴露 ORCA_DEV_REPO_ROOT 的开发检出中使用 orca-dev；否则在非 Orca 管理终端的 Linux 上使用 orca-ide，切勿直接运行裸 orca，因为那里通常解析为 GNOME Orca 屏幕阅读器并启动语音；其他情况使用 orca。文档中的 ORCA 是占位符，运行前需替换，不要创建 shell 变量或直接运行 ORCA 字面量。
运行前应加载完整指南：ORCA skills get orca-cli，它会打印与所选二进制版本匹配的完整指南。不要凭记忆猜测子命令或参数。可用 ORCA status --json 确认应用状态，必要时用 ORCA open --json 启动，智能体调用优先使用 --json。
限制：若较旧 Orca 不识别 skills get，仅当二进制明确报告该命令未知时，才可使用只读引导命令 ORCA status --json、ORCA worktree ps --json、ORCA terminal list --json，并提示更新 Orca；其他失败应如实报告，不要猜测或更换可执行文件。若所选可执行文件无法运行，报告确切错误并停止，不要回退到其他可执行文件。更多子命令与参数细节暂未在资料中提供。