用途：orca-cli 用于在 Orca 编辑器/运行时作为事实来源时，通过公开的 orca CLI 操作其受管资源，包括 worktree、文件夹上下文、终端、仓库、自动化、worktree 评论，以及 Orca 应用内嵌的浏览器。触发场景包括 Orca worktree、子 worktree、在 worktree 中启动 codex/claude、读取/等待/发送 Orca 终端、完整交接给其他智能体，以及控制 Orca 内浏览器。若 Orca 状态无关，应使用普通 shell 工具。
主要能力：管理 Orca 受管的 worktree 与文件夹上下文；操作终端、仓库与自动化；处理 worktree 评论；控制内嵌浏览器；支持智能体驱动的 JSON 输出。
使用方式：先确定本次会话使用的可执行文件并复用。若设置了 ORCA_CLI_COMMAND 环境变量，使用其值；否则在暴露 ORCA_DEV_REPO_ROOT 的开发检出中使用 orca-dev；否则在非 Orca 受管终端的 Linux 上使用 orca-ide，切勿直接运行裸 orca，因为那里通常解析为 GNOME Orca 屏幕阅读器；其余情况使用 orca。文中 ORCA 为占位符，运行前需替换，不要创建 shell 变量或直接运行 ORCA。运行 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 可恢复完整指南。
限制：本文件仅为发现存根，不是用法指南；完整参考由 orca 二进制提供，以避免与运行命令的二进制版本漂移。若所选可执行文件无法运行，应报告确切错误并停止，不要回退到其他可执行文件。除上述有界只读命令外，不要猜测旧二进制可能不支持的命令面。