orca-cli

Orca CLI 是 Orca 提供的命令行接口，用于操作 Orca 管理的多种资源，包括工作树（worktrees）、文件夹上下文、终端、仓库、自动化、产物（artifacts）、技能共享、工作树评论以及 Orca 内置浏览器。

用途 该 CLI 面向需要在 Orca 环境中以命令行方式管理上述资源的用户。它本身是一个“发现存根”（discovery stub），会加载与本次会话所用 Orca 可执行文件版本匹配的指南，因此使用前需要先确定正确的可执行文件并加载对应指南。

主要能力 根据资料，Orca CLI 可操作的对象包括：Orca 管理的工作树、文件夹上下文、终端、仓库、自动化、产物、技能共享、工作树评论，以及 Orca 内置浏览器。

使用方式

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

   • 若设置了环境变量 ORCA_CLI_COMMAND，使用其值。Orca 会为受管理的 WSL 会话导出该变量。
   • 否则，在暴露了 ORCA_DEV_REPO_ROOT 的开发检出（dev checkout）中，使用 orca-dev。
   • 否则，在 Orca 管理终端之外的 Linux 上，使用 orca-ide。切勿在该环境下直接运行裸 orca——在 Orca 终端之外，它通常解析为 GNOME Orca 屏幕阅读器（/usr/bin/orca），会在用户机器上启动语音。
   • 否则，使用 orca。 下文中的 ORCA 是所选可执行文件的占位符，运行前需替换，不要创建 shell 变量或直接运行 ORCA 字面量。该方式在 POSIX shell、PowerShell 和 cmd.exe 中同样适用。 如果所选可执行文件无法运行，应报告其确切错误并停止，不要回退到其他可执行文件，否则可能静默指向不同的 Orca 构建。

2. 在运行 Orca 命令前加载版本匹配的指南： ORCA skills get orca-cli

3. 优先使用 --json。对于指南未覆盖的命令或标志，使用所选可执行文件的 --help。

4. 若命令报告 Orca 未运行，用 ORCA open --json 启动后重试。

5. 若失败并返回 runtime_access_denied，说明沙箱阻止了连接：以提升权限重新运行，且不要运行 ORCA open 或重启 Orca。

6. 若 skills get 未知，说明更新 Orca 可恢复该指南；使用 --help 进行只读发现，不要猜测不支持的命令。

适用场景 适用于在 Orca 环境中通过命令行管理其工作树、终端、仓库、自动化、产物、技能共享、评论和内置浏览器等资源的场景，尤其适合受管理的 WSL 会话或开发检出环境。

限制 该工具为发现存根，需先加载版本匹配的指南才能运行 Orca 命令；必须使用正确的可执行文件，不能回退到其他可执行文件；在 Orca 终端之外的 Linux 上不能直接运行裸 orca；遇到 runtime_access_denied 时需提升权限且不得重启 Orca；skills get 未知时需更新 Orca，且不应猜测不支持的命令。关于收费、价格、平台支持范围等具体信息，资料暂未提供。