用途:Orca CLI 用于在 Orca 编辑器/运行时作为事实来源时执行操作,覆盖 Orca 管理的 worktree、文件夹上下文、终端、仓库、自动化、worktree 评论以及 Orca 应用内嵌浏览器。触发场景包括 $orca-cli、Orca worktree、子 worktree、在 worktree 中启动 codex/claude、读取/等待/发送 Orca 终端、完整交接(handoff/handover)、把任务交给另一个智能体,以及控制 Orca 内置浏览器。若 Orca 状态无关,应使用普通 shell 工具。
主要能力:管理 worktree 与文件夹上下文、操作终端、处理仓库与自动化、读写 worktree 评论、控制内置浏览器,并支持以 --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。
旧版本回退:仅当所选二进制明确报告 skills get 是未知命令时,才使用只读引导命令 ORCA status --json、ORCA worktree ps --json、ORCA terminal list --json,并告知用户更新 Orca 可恢复完整指南。其他失败不应视为旧版本证据,应报告错误而非猜测或更换可执行文件。
限制:完整用法指南由 orca 二进制自身提供,本文件仅为发现存根,不列出具体子命令与标志;若所选可执行文件无法运行,应报告确切错误并停止,不要回退到其他可执行文件。