aio-ade-cli

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

AIO-ADE CLI

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

aio-ade

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

Engage AIO-ADE whenever its running editor/runtime is the source of truth: AIO-ADE-managed worktrees, folder contexts, terminals, repos, automations, worktree comments, and the browser embedded inside the AIO-ADE app. Triggers include "$aio-ade-cli", "AIO-ADE worktree", "child worktree", "spawn codex/claude in a worktree", "read/wait/send AIO-ADE terminal", "full handoff" / "handover" / "give this to another agent", and "control the browser inside AIO-ADE". Use plain shell tools when AIO-ADE state does not matter.

本文件只是一个用于发现信息的入口文件，并非使用指南。完整且与版本匹配的 AIO-ADE CLI 参考文档由

aio-ade

二进制文件自身提供。这里特意不收录该文档，以免其内容与实际运行命令的二进制文件版本发生偏差。

只要 AIO-ADE 正在运行的编辑器或运行时是权威状态源，就应使用 AIO-ADE，包括由 AIO-ADE 管理的 worktree、文件夹上下文、终端、仓库、自动化任务、worktree 评论，以及 AIO-ADE 应用内嵌的浏览器。触发语包括“$aio-ade-cli”、“AIO-ADE worktree”、“child worktree”、“spawn codex/claude in a worktree”、“read/wait/send AIO-ADE terminal”、“full handoff”、“handover”、“give this to another agent”和“control the browser inside AIO-ADE”。如果 AIO-ADE 状态无关紧要，则可使用普通 shell 工具。

Resolve the CLI for this session

为本次会话解析 CLI

Choose the executable once and reuse it for every later command:

If the
```
AIO_ADE_CLI_COMMAND
```
environment variable is set, use its value. AIO-ADE exports this for managed WSL sessions.
Otherwise, in a dev checkout whose session exposes
```
AIO_ADE_DEV_REPO_ROOT
```
, use
```
aio-ade-dev
```
.
Otherwise, use
```
aio-ade
```
. It is the same name on every platform: the pre-rebrand CLI needed a separate Linux name because a bare
```
orca
```
collided with the GNOME Orca screen reader (
```
/usr/bin/orca
```
), and
```
aio-ade
```
does not.
Otherwise, use
```
aio-ade
```
.

Below,

AIO_ADE

is a placeholder for the executable you resolved. Substitute it before running anything; do not create a shell variable or run

AIO_ADE

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 AIO-ADE build.

选择一次可执行文件，并在后续所有命令中重复使用它：

如果设置了
```
AIO_ADE_CLI_COMMAND
```
环境变量，就使用其值。AIO-ADE 会为受管理的 WSL 会话导出此变量。
否则，如果当前会话所在的开发检出暴露了
```
AIO_ADE_DEV_REPO_ROOT
```
，则使用
```
aio-ade-dev
```
。
否则，使用
```
aio-ade
```
。它在所有平台上的名称都相同：改名前的 CLI 在 Linux 上需要使用单独的名称，因为直接使用
```
orca
```
会与 GNOME Orca 屏幕阅读器（
```
/usr/bin/orca
```
）发生冲突，而
```
aio-ade
```
不会。
否则，使用
```
aio-ade
```
。

下文中的

AIO_ADE

是所解析可执行文件的占位符。运行任何命令前都应将其替换为实际名称；不要创建 shell 变量，也不要直接运行

AIO_ADE

。此规则在 POSIX shell、PowerShell 和 cmd.exe 中均适用。

如果选定的可执行文件无法运行，请报告其确切错误并停止操作。不要切换到另一个可执行文件，否则可能会在不知情的情况下操作另一个 AIO-ADE 构建版本。

Load the full guide before running AIO-ADE commands

运行 AIO-ADE 命令前加载完整指南

text

AIO_ADE skills get aio-ade-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 AIO-ADE releases, and this file deliberately no longer lists them. Confirm the app is up with

AIO_ADE status --json

(start it with

AIO_ADE open --json

if needed), and prefer

--json

for agent-driven calls.

text

AIO_ADE skills get aio-ade-cli

该命令会输出与接下来实际处理命令的二进制文件完全匹配、版本一致的完整指南，涵盖 worktree、交接、终端、自动化任务和内置浏览器。请先阅读该指南，再运行所需的特定命令。

不要凭记忆或根据此入口文件的缓存副本猜测子命令或标志。它们会随着 AIO-ADE 版本发布而发生变化，因此本文件特意不再列出这些内容。使用

AIO_ADE status --json

确认应用已启动；如有必要，可使用

AIO_ADE open --json

启动。对于面向 Agent 的调用，应优先使用

--json

。

If an older AIO-ADE does not recognize

skills get

如果旧版 AIO-ADE 无法识别

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

AIO_ADE status --json
AIO_ADE worktree ps --json
AIO_ADE terminal list --json

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

AIO_ADE skills get aio-ade-cli

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

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

skills get

是未知命令时，才使用以下回退方案。其他失败不能证明它是旧版二进制文件；应直接报告错误，而不是猜测或更换可执行文件。

对于已确认属于指南引入前的旧版本，仅可使用以下范围受限的只读命令来初步了解情况。不要陷入僵局，也不要自行杜撰命令：

text

AIO_ADE status --json
AIO_ADE worktree ps --json
AIO_ADE terminal list --json

然后告知用户，更新 AIO-ADE 后即可通过

AIO_ADE skills get aio-ade-cli

恢复完整且与版本匹配的指南。除上述命令外，应向用户询问，不要猜测此旧版二进制文件可能不支持的命令接口。

aio-ade-cli

Original

Translation

AIO-ADE CLI

AIO-ADE CLI

Resolve the CLI for this session

为本次会话解析 CLI

Load the full guide before running AIO-ADE commands

运行 AIO-ADE 命令前加载完整指南

If an older AIO-ADE does not recognize
`skills get`

如果旧版 AIO-ADE 无法识别
`skills get`