Orca CLI 是一套面向 Orca 工作环境的命令行操作入口。根据资料,它可用于操作 Orca 管理的 worktree、文件夹上下文(folder contexts)、终端、仓库、automations、artifacts、技能共享(skill sharing)、worktree comments,以及 Orca 的内置浏览器。
使用方式上,资料给出了解析可执行文件的方法。本页是 discovery stub,会从本次会话所使用的 Orca 可执行文件中加载与版本匹配的指南,因此第一步是按顺序确定要用的可执行文件,并在后续命令中复用同一个:如果设置了 ORCA_CLI_COMMAND 环境变量,就使用它的值(Orca 会为受管的 WSL 会话导出该变量);否则,如果开发检出(dev checkout)的会话暴露了 ORCA_DEV_REPO_ROOT,则使用 orca-dev;否则,在 Orca 管理终端之外的 Linux 上使用 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 启动后重试。如果 skills get 未知,应说明更新 Orca 可恢复该指南,并使用 --help 进行只读探索,不要猜测不受支持的命令。
适用场景为需要在 Orca 环境中以命令行方式处理工作区、仓库、终端、自动化与工件等任务,且希望输出可被程序化处理的用户。限制在于:本资料为发现存根与使用前置说明,未提供具体命令清单、参数细节、功能效果、收费与价格或平台支持范围等信息,这些内容暂未提供;实际可用能力需以版本匹配指南和 --help 为准。