orca-cli

stablyai/orca/orca-cli

此技能作为发现存根，而非完整使用指南。完整且与版本匹配的 Orca CLI 参考由 orca 二进制文件本身提供，有意不包含在此文件中，以避免与将实际运行命令的二进制文件脱节。当 Orca 正在运行的编辑器/运行时是事实来源时，请使用 Orca：Orca 管理的工作树、文件夹上下文、终端、仓库、自动化、工作树评论以及 Orca 应用内嵌的浏览器。触发词包括 "$orca-cli"、"Orca worktree"、"child worktree"、"spawn codex/claude in a worktree"、"read/wait/send Orca terminal"、"full handoff" / "handover" / "give this to another agent" 以及 "control the browser inside Orca"。当 Orca 状态无关紧要时，请使用普通 shell 工具。要解析当前会话的 CLI，请根据环境变量或上下文选择可执行文件：如果设置了 ORCA_CLI_COMMAND，则使用其值；否则，在暴露 ORCA_DEV_REPO_ROOT 的开发检出中使用 orca-dev；否则，在 Orca 管理终端之外的 Linux 上使用 orca-ide（切勿直接运行 orca，因为它可能解析为 GNOME Orca 屏幕阅读器）；否则，使用 orca。在运行任何命令之前，请先通过 `ORCA skills get orca-cli` 加载完整指南，该命令会打印与将处理命令的二进制文件匹配的完整指南。不要凭记忆或此存根的缓存副本猜测子命令或标志，因为它们会随 Orca 版本而变化。如果较旧的 Orca 无法识别 `skills get`，请仅使用有界、只读的引导命令：`ORCA status --json`、`ORCA worktree ps --json` 和 `ORCA terminal list --json`，然后告知用户更新 Orca 可恢复完整指南。

安装量 · 4,719查看来源

Installation

npx skills add https://stablyai/orca/

技能文件

SKILL.md

最近同步 · 2026年10月22日

SKILL.md›

---
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_COMMAND` environment 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`, use `orca-dev`.
- Otherwise, on Linux outside an Orca-managed terminal, use `orca-ide`. Never run bare
  `orca` there — 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

```text
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.