Pebrel 文档

文档 / AI 工作流

支持的 AI 命令行工具

查看 Pebrel 能识别哪些 AI CLI 和 TUI,以及每个工具有哪些状态、图标和会话功能。

说明 本页按 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 集成。

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

工具启动命令专属图标恢复对话分叉对话
Claude Codeclaude✓✓✓
Codexcodex✓✓✓
OpenCodeopencode✓✓✓
Cursor Agentagent、cursor-agent—✓—
Kimi Codekimi✓✓✓
Pipi✓✓✓
Oh My Piomp✓✓✓
GitHub Copilotcopilot—✓—
Grokgrok✓✓✓

几点说明:

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

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

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

工具启动命令专属图标
Gemini CLIgemini—
Ampamp—
Antigravityagy、antigravity✓
Clinecline—
Devindevin—
Droiddroid—
Hermeshermes—
Kirokiro、kiro-cli—
Kilo Codekilo—
Qoderqodercli—
Makimaki—
CodeBuddy Codecodebuddy、cbc✓

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

目前只做识别的工具

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

工具启动命令专属图标
Aideraider—
Goosegoose—
Auggieauggie—
Vibevibe—
Qwen Codeqwen—
Trae CLItrae-cli✓

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

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

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

名单之外的工具

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

接下来的方向

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

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

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

常见问题

状态没有更新,或图标没有出现

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

在标签上怎么看状态

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

通知来自哪个窗格

通知会指向发出事件的窗格。多个工具同时运行时,请按窗格上的图标和名称区分,通知方式见通知。

设置里没有我的工具

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

恢复或分叉没有出现

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

关于本页

内容来自用户指南 PR #291,原始基线 v2.1.1。2026-10-21 增补未发布的 OSC 7501 能力边界;原有集成名单保留 v2.1.1 基线。

Markdown 原文 ↓发行说明 ↗
核对来源

搜索文档

输入关键词,搜索使用指南。

本地全文搜索 PAGEFIND / 不上传搜索内容