用途：当 Orca 正在运行的编辑器/运行时是事实来源时，用 orca CLI 操作 Orca 管理的工作树、文件夹上下文、终端、仓库、自动化、工作树评论以及 Orca 应用内嵌浏览器。触发场景包括 Orca 工作树、子工作树、在工作树中启动 codex/claude、读取/等待/发送 Orca 终端、完整交接给其他智能体、控制 Orca 内置浏览器。若 Orca 状态无关，则用普通 shell 工具。
主要能力：工作树与子工作树管理、文件夹上下文、终端读写与等待、仓库操作、自动化、工作树评论、内置浏览器控制，以及面向智能体调用的 JSON 输出。
使用方式：先为本次会话解析可执行文件并全程复用。若设置了 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。若所选可执行文件无法运行，报告确切错误并停止，不要回退到其他可执行文件。运行 Orca 命令前先加载完整指南：ORCA skills get orca-cli，它会打印与将处理后续命令的确切二进制匹配的完整指南。不要凭记忆或缓存猜测子命令与标志。用 ORCA status --json 确认应用已启动（必要时用 ORCA open --json 启动），智能体调用优先使用 --json。
限制：若旧版 Orca 不识别 skills get，仅当所选二进制明确报告 skills get 是未知命令时才使用回退，且只做有界的只读引导：ORCA status --json、ORCA worktree ps --json、ORCA terminal list --json，然后告知用户更新 Orca 可恢复完整指南；除此之外应询问用户而非猜测命令面。其他失败不证明是旧版二进制，应报告而非猜测或更换可执行文件。