用途：orca-cli 用于操作由 Orca 运行编辑器/运行时管理的对象，包括 Orca 管理工作树、文件夹上下文、终端、仓库、自动化、工作树评论，以及 Orca 应用内嵌的浏览器。当 Orca 状态是唯一事实来源时应使用它；若 Orca 状态无关，则用普通 shell 工具。
主要能力：可处理工作树相关操作、在子工作树中启动 codex/claude、读取/等待/发送 Orca 终端内容、执行“完整交接”把任务交给另一个智能体，以及控制 Orca 内的浏览器。
使用方式：先解析本次会话要用的可执行文件并全程复用。若设置了 ORCA_CLI_COMMAND 环境变量，用它；在暴露 ORCA_DEV_REPO_ROOT 的开发检出中用 orca-dev；在 Orca 托管终端之外的 Linux 上使用 orca-ide，切勿在该场景直接运行裸 orca，因为那里通常解析为 GNOME Orca 屏幕阅读器（/usr/bin/orca）并启动语音；否则使用 orca。下文 ORCA 为该可执行文件的占位符，需在运行前替换，不要创建 shell 变量或直接运行 ORCA。运行命令前先加载完整指南：ORCA skills get orca-cli，该命令会打印与将要执行命令的二进制完全匹配的完整指南，涵盖工作树、交接、终端、自动化与内置浏览器；先读再执行具体命令。不要凭记忆或缓存副本猜测子命令与标志，它们会随 Orca 版本变化。可用 ORCA status --json 确认应用已启动（必要时用 ORCA open --json 启动），面向智能体的调用优先使用 --json。
限制：若所选可执行文件无法运行，报告其确切错误并停止，不要回退到其他可执行文件，以免静默指向不同 Orca 构建。仅当所选二进制明确报告 skills get 是未知命令时，才使用只读引导命令：ORCA status --json、ORCA worktree ps --json、ORCA terminal list --json，并告知用户更新 Orca 即可恢复完整版本匹配指南。除这些命令外应询问用户，不要猜测旧二进制可能不支持的命令面。