# 支持的 AI 命令行工具

> **说明**
> 本页按 Pebrel 2.1.1 核对。支持范围会随版本变化；如果你安装的版本较旧，设置 → Agents 里列出的工具可能比这里少，请以自己版本的界面为准。

## Pebrel 如何对待 AI 命令行工具

Claude Code、Codex 这类工具本质上是运行在终端里的程序，所以任何 CLI 或 TUI 都能在 Pebrel 里正常使用，不需要先"被支持"。Pebrel 做的是在此之上多走一步：认出你正在运行的是哪一个工具，再给它配上图标、任务状态、通知和对话接续。

这些能力分三层，工具支持到哪一层，你能得到的体验就到哪一层：

| 层级 | 你会得到什么 | 需要你做什么 |
| --- | --- | --- |
| **识别** | Pebrel 认出工具名称，可显示专属图标 | 不需要，直接运行即可 |
| **屏幕识别** | 在识别的基础上，Pebrel 根据终端画面判断工具是在工作，还是在等你确认 | 不需要 |
| **Agent 集成** | 工具自己把"开始、完成、需要你处理"等事件告诉 Pebrel，提供事件与通知；还能记住会话，用于恢复与分叉 | Claude Code 和 Codex 默认已开启；其他工具在 **设置 → Agents** 里打开一次 |

Agent 集成提供显式事件，但并不是所有工具都提供可用的事件接口。没有集成的工具，依然可以靠屏幕识别获得不错的状态提示，只是在工具改了界面措辞之后，判断可能暂时不准。

## OSC 7501 与版本范围

**2026-10-21 合入主线，尚未包含在 v2.2.2 发布包中。** 支持的客户端实际发送有效报告时，桌面 Windows、macOS、Linux 的本地 PTY 和内置 SSH 共用 OSC 7501 状态解析。

状态选择顺序是：真实的窗格或连接失败优先，其次有效 OSC 7501，然后 Hook，最后屏幕与进程启发式。协议可表达空闲、进行、完成、阻塞、报错，并细分权限、问题和认证请求。各客户端、版本和终端复用链路的发送能力不同，不保证每个工具都报告五种状态。

Hook 继续提供会话身份、回答捕获和可操作的权限请求。单独收到协议状态不等于能够自动执行权限操作，也不代表会产生所有 Hook 通知。

Android 远控可以继承桌面的任务状态；手机独立终端和直连 SSH 尚未接入这条状态投影。macOS 和 Linux 的原生任务栏进度也不等同于桌面标签状态。

## 支持 Agent 集成的工具

**设置 → Agents** 页面里列出的就是下面这 9 个工具，在 Windows、macOS 和 Linux 上都可以使用。Claude Code 和 Codex 默认开启，其余的需要自己打开开关；开启后要退出并重新启动对应的工具才会生效，步骤见[配置 Agent 集成](/docs/hooks/)。

服务器上的工具也可以使用：通过 Pebrel 的 SSH 连接时，会自动为服务器上的 Claude Code、Codex、OpenCode 和 Pi 配置集成。WSL 里则支持 Claude Code 和 Codex。

| 工具 | 启动命令 | 专属图标 | 恢复对话 | 分叉对话 |
| --- | --- | :---: | :---: | :---: |
| Claude Code | `claude` | ✓ | ✓ | ✓ |
| Codex | `codex` | ✓ | ✓ | ✓ |
| OpenCode | `opencode` | ✓ | ✓ | ✓ |
| Cursor Agent | `agent`、`cursor-agent` | — | ✓ | — |
| Kimi Code | `kimi` | ✓ | ✓ | ✓ |
| Pi | `pi` | ✓ | ✓ | ✓ |
| Oh My Pi | `omp` | ✓ | ✓ | ✓ |
| GitHub Copilot | `copilot` | — | ✓ | — |
| Grok | `grok` | ✓ | ✓ | ✓ |

几点说明：

- Cursor Agent 的命令是 `agent`，不是 Cursor 桌面编辑器的 `cursor`。只安装了桌面编辑器时，设置里不会把 Cursor Agent 显示为已安装。
- 没有专属图标的工具会用字体图标代替：Gemini、Cursor Agent 和 GitHub Copilot 各有自己的图案，其余工具显示通用图标。这不影响状态提示。
- "恢复"指重新打开 Pebrel 后接回原来的对话，或在 [AI 会话历史](/docs/ai-history/) 里重新打开某次对话。"分叉"指从已有对话的上下文开出一个新对话，原对话保持不变。两者都要求 Pebrel 已经知道这次对话的会话标识，而这正是 Agent 集成带来的。

## 通过屏幕识别获得状态提示的工具

下面这些工具目前没有 Agent 集成入口，但 Pebrel 能认出它们，并根据画面判断工作中或等待确认。

| 工具 | 启动命令 | 专属图标 |
| --- | --- | :---: |
| Gemini CLI | `gemini` | — |
| Amp | `amp` | — |
| Antigravity | `agy`、`antigravity` | ✓ |
| Cline | `cline` | — |
| Devin | `devin` | — |
| Droid | `droid` | — |
| Hermes | `hermes` | — |
| Kiro | `kiro`、`kiro-cli` | — |
| Kilo Code | `kilo` | — |
| Qoder | `qodercli` | — |
| Maki | `maki` | — |
| CodeBuddy Code | `codebuddy`、`cbc` | ✓ |

这一档的工具不在 Pebrel 里恢复或分叉对话。需要接续时，使用工具自己的恢复命令即可，例如 `gemini --resume`。

## 目前只做识别的工具

下面这些工具能被认出，但暂时没有屏幕识别规则，也没有集成。任务状态提示比较有限，需要你自己回到窗格查看。

| 工具 | 启动命令 | 专属图标 |
| --- | --- | :---: |
| Aider | `aider` | — |
| Goose | `goose` | — |
| Auggie | `auggie` | — |
| Vibe | `vibe` | — |
| Qwen Code | `qwen` | — |
| Trae CLI | `trae-cli` | ✓ |

## 通过 `npx` 等启动器运行也能识别

Pebrel 不只看命令的第一个词。通过 `node`、`npx`、`bunx`、`uvx`、`pipx` 等启动器运行的工具，以及在 WSL 里运行的工具，同样会被认出。

如果工具没有被认出，先在同一个终端里确认命令能直接运行，再看[配置 Agent 集成](/docs/hooks/)中的排查步骤。

## 名单之外的工具

不在上面名单里的 CLI 或 TUI，仍然可以在 Pebrel 里正常运行，只是没有专属图标、任务状态和对话接续，终端本身的所有功能不受影响。

## 接下来的方向

下面是目前的开发方向，不是发布时间的承诺，具体以各版本的发布说明为准：

- **补齐集成。** 优先为使用广泛、并且官方提供稳定事件接口的工具增加 Agent 集成，让它们从"屏幕识别"获得显式事件支持。
- **扩大恢复和分叉的范围。** 只在工具的官方命令经过核对之后才会加入。Pebrel 不会按名字猜测命令，以免把内容输入到错误的位置。
- **识别更多工具。** 新工具会根据使用情况和启动方式是否稳定来评估。

希望支持某个工具，可以在项目的 Issue 里说明工具名称、启动命令和官方文档链接，流程见[参与贡献](/docs/contributing/)。

## 常见问题

### 状态没有更新，或图标没有出现

先确认命令在同一个终端里能直接运行，再刷新 **设置 → Agents**。已经启用集成的工具，重启一次工具后再试。工具刚升级过时，重新启动 Pebrel 和工具可以清掉旧的识别状态。

### 在标签上怎么看状态

工作中的标签会显示转动的进度标记。工具停下来等你输入或授权时，标签会改为相应的提示。任务完成时，标签先短暂显示对勾，再变成一个小圆点，提醒你回去查看；正在查看的标签不会显示这个小圆点。详见[使用 AI 命令行工具](/docs/ai-start/)。

### 通知来自哪个窗格

通知会指向发出事件的窗格。多个工具同时运行时，请按窗格上的图标和名称区分，通知方式见[通知](/docs/notifications/)。

### 设置里没有我的工具

**设置 → Agents** 只列出有 Agent 集成的 9 个工具。其他工具没有开关，但仍会被识别，并显示图标和状态提示。

### 恢复或分叉没有出现

先看工具是否在上面"支持 Agent 集成"的表里且有 ✓，再检查集成是否已启用并重启过工具。SSH 标签和自定义 Profile 里不会显示分叉入口，详情见[恢复与分叉 AI 对话](/docs/ai-history/)。

---
Source: Kuddev/pebrel PR #291, WilliamWang1721 and Pebrel contributors.
Adapted for pebrel.com. License: GPL-3.0.
