> ## Documentation Index
> Fetch the complete documentation index at: https://docs.avibe.bot/llms.txt
> Use this file to discover all available pages before exploring further.

# 命令

> 常用 Avibe CLI 和聊天命令。

# 命令

## 本地 CLI

### 服务生命周期

| 命令                               | 作用                      |
| -------------------------------- | ----------------------- |
| `vibe`                           | 启动 Avibe 并打开本地 Web UI   |
| `vibe status`                    | 显示本地服务和配置状态             |
| `vibe restart`                   | 重启所有服务                  |
| `vibe restart --delay-seconds N` | 延迟 `N` 秒重启，让进行中的对话先收到回复 |
| `vibe stop`                      | 停止本地 Avibe 服务           |
| `vibe doctor`                    | 对常见设置问题运行诊断             |
| `vibe version`                   | 打印已安装版本                 |

### 远程 Web UI

| 命令                       | 作用                                   |
| ------------------------ | ------------------------------------ |
| `vibe remote`            | 引导式登录并配对 avibe.bot tunnel            |
| `vibe remote pair <key>` | 直接用从 avibe.bot 拿到的一次性 key 进行配对       |
| `vibe remote status`     | 查看配对和 tunnel 状态（加 `--json` 得到机器可读输出） |
| `vibe remote start`      | 配对完成后启动 cloudflared tunnel           |
| `vibe remote stop`       | 停止 tunnel，但保留配对配置                    |

### 更新

| 命令                  | 作用              |
| ------------------- | --------------- |
| `vibe check-update` | 检查是否有更新版本       |
| `vibe upgrade`      | 升级 Avibe 到最新发布版 |

### 实用工具

| 命令                | 作用             |
| ----------------- | -------------- |
| `vibe screenshot` | 把本地桌面截图保存为 PNG |

### Show Pages

| 命令                                                          | 作用                                                              |
| ----------------------------------------------------------- | --------------------------------------------------------------- |
| `vibe show status` / `path` / `list`                        | 查看、解析或列出会话的 [Show Page](/zh/concepts/show-pages)                |
| `vibe show update --visibility private\|public\|offline`    | 设置可见性、自定义公开链接，或把页面下线                                            |
| `vibe show annotate --on\|--off [--mode smart\|screenshot]` | 打开/关闭用户的[标注](/zh/concepts/annotating-show-pages)层或切换模式（不产生聊天消息） |
| `vibe show reply <event-id> --message "…"`                  | 回答页面上的一条标注，锚定在用户所指的位置                                           |
| `vibe show mark <target> --message "…"`                     | 在某个元素上留一条说明（同一目标会替换）                                            |
| `vibe show marks` / `vibe show unmark <id-或-target> …`      | 列出活跃标记 / 退场一个或多个                                                |

Show Page 是 agent 的可视化界面，[标注](/zh/concepts/annotating-show-pages) 闭环就跑在它们上面：
用户指向页面，agent 在页面上回答。这些命令由 agent 驱动——用户很少直接运行。

### Vaults

| 命令                                  | 作用                         |
| ----------------------------------- | -------------------------- |
| `vibe vault list` / `find` / `tags` | 查找密钥名称和不含值的元数据，不暴露密钥值      |
| `vibe vault request <name>`         | 请求用户在 Workbench 中提供一个缺少的密钥 |
| `vibe vault run`                    | 把选定的静态密钥只注入一个子进程           |
| `vibe vault fetch`                  | 在 HTTP 出站边界把静态凭证附加到认证请求    |
| `vibe vault access` / `await`       | 请求保护档使用授权，并读取已完成的请求        |
| `vibe vault sign`                   | 用密钥对签署 32 字节摘要；私钥永不导出      |

Agent 按密钥名称、标签或 Skill 标签引用 [Vaults](/zh/concepts/vaults)。
标准档密钥现已可用。保护档操作描述的是上线前 passkey 流程；不可变 sandbox
完整性门禁启用前，不得存放真实密钥。使用 `vibe vault run` 时，不要运行会打印
环境变量或含密钥调试输出的命令。

### Agent Harness

| 命令                                                                  | 作用                                                                  |
| ------------------------------------------------------------------- | ------------------------------------------------------------------- |
| `vibe agent run`                                                    | 立即运行一次 Agent；加 `--async` 可放到后台执行，或用 `--fork-session` 从已有 Session 分叉 |
| `vibe runs list` / `show` / `cancel`                                | 查看和管理每一次具体的 Agent Run 记录                                            |
| `vibe task add`                                                     | 保存一个定时或一次性时间触发器，之后创建 Agent Run                                      |
| `vibe task list`                                                    | 列出已保存任务（可加 `--brief` 或 `--all`）                                     |
| `vibe task show` / `update` / `pause` / `resume` / `run` / `remove` | 管理单个已保存任务                                                           |
| `vibe watch add`                                                    | 启动一个被管理的等待器，成功后创建跟进 Agent Run                                       |
| `vibe watch list` / `show` / `pause` / `resume` / `remove`          | 管理单个 watch                                                          |

这些命令共同组成 Avibe Harness。用户可以让 Agent 盯 PR、等 CI、
安排每日状态检查、新开一个调查会话，或者并行启动多个后台检查。Agent
可以组合这些基础工具，用户不需要记住每一个参数。

每个子命令都支持 `--help` 查看完整参数，包括 `--session-id`、
`--fork-session`、`--post-to`、`--deliver-key`、`--message`、
`--message-file`、`--cron`、`--at`、`--async` 和 `--timezone`（视命令而定）。

当一个新 Agent Session 需要从已有 Session 的 native backend 上下文分叉时，
使用 `vibe agent run --fork-session <session-id> --message "..."`。
fork 会保持源 Session 的 backend；只有 Agent backend 不变时，`--agent`、
`--model` 和 `--reasoning-effort` 才能覆盖 fork 后 Session。

## 聊天用法

| 在聊天里         | 作用              |
| ------------ | --------------- |
| Mention bot  | 启动任务或提问         |
| 在 thread 里回复 | 继续同一个 Agent 会话  |
| `/stop`      | 在支持的平台停止当前会话    |
| 在启用范围内直接发消息  | 把工作发给配置好的 Agent |