orca-cli

用途

Orca CLI 是一个命令行接口技能，用于在 Orca 运行中的编辑器/运行时作为事实来源时，操作 Orca 所管理的各类对象。根据资料，其覆盖范围包括：Orca 管理的 worktree、文件夹上下文、终端、仓库、自动化任务、产物、worktree 评论，以及 Orca 应用内嵌的浏览器。

触发场景包括：$orca-cli、"Orca worktree"、"child worktree"、在 worktree 中启动 codex/claude、读取/等待/发送 Orca 终端内容、完整交接（full handoff / handover / 交给另一个智能体）、以及控制 Orca 内嵌浏览器。当 Orca 状态无关紧要时，资料建议使用普通 shell 工具。

主要能力

• 操作 Orca 管理的 worktree（含子 worktree、在 worktree 中启动 codex/claude）。
• 管理文件夹上下文、终端、仓库。
• 处理自动化任务与产物。
• 管理 worktree 评论。
• 控制 Orca 应用内嵌的浏览器。
• 支持会话间交接（handoff / handover）。

使用方式

1. 解析本次会话的 CLI 可执行文件，选定后对所有后续命令复用：

   • 若设置了 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。该规则同样适用于 POSIX shell、PowerShell 和 cmd.exe。
   • 若所选可执行文件无法运行，应报告其确切错误并停止，不要回退到其他可执行文件，以免静默指向不同的 Orca 构建。

2. 运行 Orca 命令前加载完整指南：执行 ORCA skills get orca-cli，它会输出与将要处理后续命令的确切二进制匹配的完整指南（涵盖 worktree、交接、终端、自动化与内置浏览器）。应先阅读该指南，再运行所需的具体命令。资料强调不要凭记忆或缓存的桩文件猜测子命令或参数，因为它们会随 Orca 版本变化。确认应用已启动可用 ORCA status --json（如需要以 ORCA open --json 启动），面向智能体的调用优先使用 --json。

3. 若旧版 Orca 不识别 skills get：仅当所选二进制明确报告 skills get 是未知命令时才使用回退方案。其他失败不能证明是旧版二进制；应报告该失败，而不是猜测或更换可执行文件。对于确认的无指南二进制，仅使用以下有界、只读的引导命令定位：

   • ORCA status --json
   • ORCA worktree ps --json
   • ORCA terminal list --json 然后告知用户升级 Orca 即可通过 ORCA skills get orca-cli 恢复完整的版本匹配指南。除此之外，应询问用户，而不是猜测该旧二进制可能不支持的完整命令面。

适用场景

当 Orca 运行中的编辑器/运行时是操作对象的事实来源时使用本技能，例如管理 worktree、在 worktree 中启动编码智能体、读取或发送终端内容、执行智能体间交接、控制内嵌浏览器等。若 Orca 状态不重要，宜使用普通 shell 工具。

限制

• 本文件仅为发现桩，不是使用指南；完整、版本匹配的 Orca CLI 参考由 orca 二进制自身提供，以避免与将实际运行命令的二进制产生偏差。
• 子命令与参数会随 Orca 版本变化，不应凭记忆或缓存桩文件猜测。
• 在不恰当环境直接运行裸 orca 可能触发 GNOME 屏幕阅读器。
• 若所选可执行文件无法运行，不应回退到其他可执行文件。
• 旧版二进制的命令面可能与本指南不同，需谨慎并询问用户。
• 资料未提供具体的命令列表、价格、平台支持范围等信息，相关内容暂未提供。