Orca CLI 面向需要以命令行方式操控 Orca 所管理开发资源的用户。其用途是让脚本或代理式会话能够操作 Orca 环境中的工作树、文件夹上下文、终端、仓库、自动化、产物、技能共享、工作树注释和内嵌浏览器等对象。
主要能力集中在上述资源的管理与操作上。资料中仅给出资源范围列举，未逐项说明每个命令的参数、返回值或具体行为，这些细节需通过加载版本匹配的指南获取。
使用方式分为两步。第一步解析本次会话应使用的可执行文件，选定后所有后续命令都复用它：若设置了 ORCA_CLI_COMMAND 环境变量，则使用其值（Orca 为受管 WSL 会话导出该变量）；否则若开发检出暴露 ORCA_DEV_REPO_ROOT，则使用 orca-dev；否则在 Orca 托管终端之外的 Linux 上使用 orca-ide；其余情况使用 orca。文档强调不要在 Linux 上运行裸 orca，因为在 Orca 终端之外它通常解析为 GNOME Orca 屏幕阅读器（/usr/bin/orca），会在用户机器上启动语音。第二步加载版本匹配的指南，命令为“ORCA skills get orca-cli”。文中 ORCA 是占位符，需替换为解析出的可执行文件，且不要创建 shell 变量或按字面运行 ORCA；在 POSIX shell、PowerShell 和 cmd.exe 中做法相同。若所选可执行文件无法运行，应报告其确切错误并停止，不要回退到其他可执行文件，以免静默指向不同版本的 Orca 构建。
使用约定：优先使用 --json；指南未覆盖的命令或参数可查看所选可执行文件的 --help。若命令报告 Orca 未运行，用“ORCA open --json”启动后重试；若失败并返回 runtime_access_denied，说明沙箱阻断了连接，应以提升的权限重跑该命令，且不要执行 ORCA open 或重启 Orca。若 skills get 不被识别，可说明更新 Orca 可恢复指南，并通过 --help 进行只读探查，不要猜测不受支持的命令。
适用场景包括在 Orca 托管终端、WSL 会话或开发检出中通过命令行管理 Orca 资源，以及需要结构化 JSON 输出的自动化流程。限制方面：必须使用正确的可执行文件并按版本加载指南；不得在 Linux 非 Orca 终端运行裸 orca；不支持的调用需先查 --help 而非猜测；具体命令清单、权限要求、平台支持范围和收费信息资料暂未提供。