orca-cli
GitHub管理 Orca 工作区、终端及浏览器等环境的 CLI 工具，支持多环境命令解析与版本指南加载，用于自动化操作和代理间交接。
Trigger Scenarios
Install
npx skills add stablyai/orca --skill orca-cli -g -y
SKILL.md
Frontmatter
{
"name": "orca-cli",
"description": "Operate Orca-managed worktrees, folder contexts, terminals, repos, automations, worktree comments, and Orca's embedded browser through the `orca` CLI. Use when the user says \"$orca-cli\", \"Orca worktree\", \"child worktree\", \"spawn codex\/claude in a worktree\", \"read\/wait\/send Orca terminal\", \"handoff\" \/ \"handover\" \/ \"give this to another agent\", or \"Orca browser\". Prefer it over raw git worktree, ad hoc PTYs, or Computer Use when Orca state is involved. Use Computer Use only when a visible window needs GUI control that a CLI, filesystem, or API cannot do."
}
Orca CLI
This discovery stub loads the version-matched guide from the Orca executable used for this session.
Resolve the CLI for this session
Choose the executable once and reuse it for every later command:
- If the
ORCA_CLI_COMMANDenvironment variable is set, use its value. Orca exports this for managed WSL sessions. - Otherwise, in a dev checkout whose session exposes
ORCA_DEV_REPO_ROOT, useorca-dev. - Otherwise, on Linux outside an Orca-managed terminal, use
orca-ide. Never run bareorcathere — outside Orca's terminals it normally resolves to the GNOME Orca screen reader (/usr/bin/orca) and starts speech on the user's machine. - Otherwise, use
orca.
Below, ORCA is a placeholder for the executable you resolved. Substitute it before
running anything; do not create a shell variable or run ORCA literally. This works the
same way in POSIX shells, PowerShell, and cmd.exe.
If the selected executable cannot run, report its exact error and stop. Do not fall through to another executable, which could silently target a different Orca build.
Load the version-matched guide before running Orca commands
ORCA skills get orca-cli
Prefer --json. Use the selected executable's --help for commands or flags the guide does
not cover. If a command reports that Orca is not running, start it with ORCA open --json
and retry. If it fails with runtime_access_denied, your sandbox blocked the connection:
re-run it with escalated permissions, and do not run ORCA open or restart Orca. If
skills get is unknown, explain that updating Orca restores the guide; use --help for
read-only discovery and do not guess unsupported commands.
Version History
-
6c6e3d9
Current 2026-11-02 19:10
优化发布指引显示逻辑，仅当主机启用时展示。
-
27b823f
2026-09-27 19:54
修复了 macOS 沙箱中连接运行时套接字被拒时的错误报告逻辑，新增 runtime_access_denied 错误码指导代理提升权限而非重启应用。
-
15472cd
2026-09-22 08:05
修复触发范围，排除文件系统和Shell任务；移除对Playwright的依赖描述；澄清Computer Use仅作为最后手段，避免编排技能错误路由至GUI工具。
-
6108ce6
2026-09-09 02:31
重写并精简非编排指南，采用结果导向标准；引入共享的 CLI 解析片段和参考路由机制；修复 SSH 配置、权限设置等已知缺陷；增加命令行参数校验和安全防护规则。
-
f19a860
2026-09-03 04:04
修复计算机使用发现边界，明确命名浏览器页面自动化工具，防止误用外部 UI 控制。
-
73f7767
2026-08-19 19:01
重新发布安全私有 bundle 共享功能（此前版本已回退）
-
c0a7754
2026-08-16 01:57
新增基于账户的工件分享功能
- eab721e 2026-07-24 11:46
