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`
命令