orca-cli

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Orca CLI

This file is a discovery stub, not the usage guide. The full, version-matched Orca CLI reference is served by the

orca

binary itself — kept out of this file on purpose so it can never drift from the binary that will actually run your commands.

Engage Orca whenever its running editor/runtime is the source of truth: Orca-managed worktrees, folder contexts, terminals, repos, automations, worktree comments, and the browser embedded inside the Orca app. Triggers include "$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", and "control the browser inside Orca". Use plain shell tools when Orca state does not matter.

本文件是一个发现存根，而非使用指南。完整的、版本匹配的 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 工具。

Resolve the CLI for this session

为本会话确定 CLI

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.

选择一次可执行程序，之后的所有命令都复用它：

如果设置了
```
ORCA_CLI_COMMAND
```
环境变量，使用其值。Orca 会为受管 WSL 会话导出此变量。
否则，在会话暴露了
```
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 构建版本。

Load the full guide before running Orca commands

运行 Orca 命令前加载完整指南

text

ORCA skills get orca-cli

That prints the complete, version-matched guide for the exact binary that will handle your next commands — worktrees, handoffs, terminals, automations, and the built-in browser. Read it first, then run the specific command you need.

Don't guess subcommands or flags from memory or from a cached copy of this stub. They change between Orca releases, and this file deliberately no longer lists them. Confirm the app is up with

ORCA status --json

(start it with

ORCA open --json

if needed), and prefer

--json

for agent-driven calls.

text

ORCA skills get orca-cli

这会打印出将处理你下一条命令的完整、版本匹配的指南——工作树、交接、终端、自动化和内置浏览器。先阅读它，然后运行你需要的特定命令。

不要根据记忆或这个存根的缓存副本来猜测子命令或标志。它们在 Orca 版本之间会变化，本文件故意不再列出它们。使用

ORCA status --json

确认应用已启动（如果需要，使用

ORCA open --json

启动它），并且对于 Agent 驱动的调用，优先使用

--json

。

If an older Orca does not recognize

skills get

如果旧版 Orca 无法识别

skills get

Use this fallback only when the selected binary explicitly reports that

skills get

is an unknown command. Another failure is not proof of an older binary; report it rather than guessing or changing executables. For a confirmed pre-guide binary, use only this bounded, read-only bootstrap to orient. Do not dead-end and do not invent commands:

text

ORCA status --json
ORCA worktree ps --json
ORCA terminal list --json

Then tell the user that updating Orca restores the full, version-matched guide via

ORCA skills get orca-cli

. Beyond these commands, ask the user rather than guessing a command surface this older binary may not support.

仅当所选二进制文件明确报告

skills get

是未知命令时，才使用此回退方案。其他失败并不能证明是旧二进制文件；报告它，而不是猜测或更改可执行文件。对于确认的预指南二进制文件，仅使用此有界的只读引导程序来定位。不要陷入死胡同，也不要发明命令：

text

ORCA status --json
ORCA worktree ps --json
ORCA terminal list --json

然后告诉用户，更新 Orca 可以通过

ORCA skills get orca-cli

恢复完整的、版本匹配的指南。除了这些命令之外，请询问用户，而不是猜测这个旧二进制文件可能不支持的命令范围。

orca-cli

Original

Translation

Orca CLI

Orca CLI

Resolve the CLI for this session

为本会话确定 CLI

Load the full guide before running Orca commands

运行 Orca 命令前加载完整指南

If an older Orca does not recognize
`skills get`

如果旧版 Orca 无法识别
`skills get`