orca-cli

用途：orca-cli 是对 Orca 应用进行命令行操作的公开 CLI，用于在 Orca 编辑/运行时状态为权威来源时，管理工作树、文件夹上下文、终端、仓库、自动化、工件、技能共享、工作树评论，以及应用内嵌浏览器。必要用法：先为当前会话解析可执行文件并全程复用。若设置了 ORCA_CLI_COMMAND 环境变量，使用其值；否则在暴露 ORCA_DEV_REPO_ROOT 的开发检出中使用 orca-dev；否则在 Linux 非 Orca 管理的终端中用 orca-ide（不要直接用裸 orca，它通常指向 GNOME Orca 屏幕阅读器并启动语音）；其余情况用 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 管理工作树、子工作树、在 worktree 中生成 codex/claude、读写或等待 Orca 终端、完整交接给另一代理、控制 Orca 内浏览器。限制：本文件只是发现存根，不列具体命令；当 Orca 状态不重要时使用普通 shell 工具；所选可执行文件无法运行时报告确切错误并停止，不要回退到其他可执行文件。