orca-cli
GitHubOrca CLI 技能，用于通过命令行操作 Orca 管理的 worktree、终端、自动化及浏览器等。提供环境检测、版本指南加载及错误处理逻辑。
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, artifacts, skill sharing, 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\", \"Orca browser\", \"orca artifacts\", or \"share skills\". 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
-
27b823f
Current 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
