用途：当 Orca 正在运行的编辑器/运行时是事实来源时，用 orca CLI 操作 Orca 管理的工作树、文件夹上下文、终端、仓库、自动化、工作树评论以及 Orca 应用内嵌浏览器。触发场景包括 Orca 工作树、子工作树、在工作树中启动 codex/claude、读取/等待/发送 Orca 终端、完整交接给其他智能体、控制 Orca 内置浏览器等。若 Orca 状态无关，应使用普通 shell 工具。
主要能力：覆盖工作树、交接、终端、自动化和内置浏览器等操作，具体子命令与参数随 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 status --json 确认应用已启动（必要时用 ORCA open --json 启动），面向智能体调用优先使用 --json。
旧版本回退：仅当所选二进制明确报告 skills get 是未知命令时，才使用以下只读引导：ORCA status --json、ORCA worktree ps --json、ORCA terminal list --json。随后告知用户更新 Orca 可恢复完整指南。除此之外应询问用户，不要猜测旧二进制可能不支持的命令面。
限制：本文件是发现存根而非使用指南，不包含完整命令参考；命令面随版本变化；在 Linux 非 Orca 终端直接运行 orca 有误触屏幕阅读器的风险。