Orca CLI 用于通过命令行操作 Orca 管理的各类对象,包括 worktree、文件夹上下文、终端、代码仓库、自动化、构件(artifacts)、技能共享、worktree 评论以及 Orca 的内置浏览器。
该页面本身是一个发现存根(discovery stub),不直接提供完整命令列表,而是加载与当前会话所用的 Orca 可执行文件版本相匹配的指南。
使用方式
首先确定本次会话应使用的可执行文件,并在后续所有命令中复用同一个,不要中途切换。选择规则如下:
- 若设置了 ORCA_CLI_COMMAND 环境变量,使用其值。Orca 会为受管理的 WSL 会话导出该变量。
- 否则,在会话暴露 ORCA_DEV_REPO_ROOT 的开发检出(dev checkout)中,使用 orca-dev。
- 否则,在 Linux 上且不在 Orca 管理的终端内时,使用 orca-ide。文档明确提示:绝不要在那种环境下直接运行裸命令 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 可执行文件内加载的对应版本指南和 --help 输出为准。