用途：当 Orca 正在运行的编辑器或运行时是事实来源时，通过命令行操作其托管的工作树、文件夹上下文、终端、仓库、自动化、工作树评论以及内嵌浏览器。若不关心 Orca 状态，应使用普通 shell 工具。触发场景包括 "$orca-cli"、Orca 工作树、子工作树、在工作树中启动 codex/claude、读取/等待/发送 Orca 终端、完整交接（handoff/handover）以及控制 Orca 内置浏览器。
主要能力：围绕 Orca 管理的工作树、终端、仓库、自动化、评论与内嵌浏览器执行操作，并支持以 JSON 输出配合代理驱动调用。
使用方式：先为当前会话确定可执行文件并全程复用。若设置了 ORCA_CLI_COMMAND 环境变量，取其值（Orca 为受管 WSL 会话导出）。否则，在暴露 ORCA_DEV_REPO_ROOT 的开发检出中使用 orca-dev。否则，在 Linux 且非 Orca 管理终端时使用 orca-ide；切勿在彼处运行裸 orca（通常会解析为 GNOME Orca 屏幕阅读器 /usr/bin/orca 并朗读）。其余情况使用 orca。文档中的 ORCA 是占位符，运行前需替换，不要创建 shell 变量或直接运行 ORCA。运行 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 可恢复完整指南。其他失败应报告而非猜测或更换可执行文件。
限制：本文件仅为发现存根，完整用法指南由 orca 二进制提供，故不在此列出具体子命令。若选定可执行文件无法运行，应报告其确切错误并停止，不要回退到其他可执行文件。