用途
orca-cli 是 Orca 环境中的一项命令行技能指南，面向需要以命令行方式操作 Orca 管理的各类资源的使用者。据资料描述，其覆盖范围包括：Orca 管理的工作树（worktrees）、文件夹上下文（folder contexts）、终端（terminals）、仓库（repos）、自动化（automations）、产物（artifacts）、技能共享（skill sharing）、工作树评论（worktree comments）以及 Orca 的内置浏览器（embedded browser）。
该技能入口本身是一个发现用的引导（discovery stub），并不直接内置完整文档，而是从本次会话所使用的 Orca 可执行文件中加载与版本匹配的指南，以保证命令说明与当前 Orca 版本一致。
主要能力
- 加载与当前 Orca 版本匹配的命令指南。
- 覆盖 Orca 管理的多种资源与功能，包括工作树、文件夹上下文、终端、仓库、自动化、产物、技能共享、工作树评论和内置浏览器。
- 支持通过 --json 获取结构化输出，资料建议优先使用 --json。
- 对指南未覆盖的命令或参数，可通过所选可执行文件的 --help 查询。
使用方式
资料给出的使用流程如下：
- 确定本次会话使用的可执行文件，并在后续所有命令中复用同一个。选择顺序为：
- 若设置了环境变量 ORCA_CLI_COMMAND，则使用其值；Orca 会为受管理的 WSL 会话导出该变量。
- 否则，在暴露了 ORCA_DEV_REPO_ROOT 的开发检出环境中，使用 orca-dev。
- 否则，在 Linux 上且不在 Orca 管理的终端中时，使用 orca-ide；不要在 Linux 上直接运行裸 orca，因为在 Orca 终端之外它通常指向 GNOME Orca 屏幕阅读器（/usr/bin/orca），会在用户机器上启动语音。
- 否则，使用 orca。
- 文中的 ORCA 是可执行文件的占位符，运行前需替换为实际解析出的可执行文件，不要创建 shell 变量或直接按字面运行 ORCA；该规则在 POSIX shell、PowerShell 和 cmd.exe 中一致。
- 若所选可执行文件无法运行，应报告其确切错误并停止，不要改用其他可执行文件，以免在不知情的情况下指向不同的 Orca 构建。
- 在运行 Orca 命令前先加载与版本匹配的指南，命令为：
ORCA skills get orca-cli
- 命令优先使用 --json 输出；指南未覆盖的命令或参数，用所选可执行文件的 --help 查询。
错误处理
- 如果命令提示 Orca 未运行，可用 ORCA open --json 启动后重试。
- 如果报错 runtime_access_denied，说明沙箱阻止了连接：应以提升权限重新运行该命令，且不要运行 ORCA open 或重启 Orca。
- 如果 skills get 不被识别，应说明更新 Orca 可恢复该指南；此时可用 --help 进行只读的探索，不要猜测不受支持的命令。
适用场景
适用于已经在 Orca 环境中工作、需要通过命令行管理 Orca 工作树、终端、仓库、自动化、产物、技能共享与工作树评论等资源的场景，也适用于需要获取与当前 Orca 版本一致的 CLI 使用说明的场合。
限制
- 该页面为引导入口，完整命令参考需从本地 Orca 可执行文件加载。
- 资料未提供安装方法、收费信息、支持平台清单或具体命令示例的完整列表，这些内容暂未提供。