Agents GUI

Agents GUI 是一个面向 VS Code 的多 Agent 工作台。它把 Claude Code、Codex CLI、Gemini CLI、OpenCode、Goose 和 Aider 等外部编码 Agent 汇聚到同一个侧边栏里，并提供上下文感知提示词、CLI 配置管理、自定义 API 供应商桥接和原生 Git 提交信息生成能力。

早期版本 v0.0.1。 核心扩展逻辑和 Webview UI 已可用，后续会围绕真实工作流持续迭代。

功能特性

• 多 Agent 侧边栏：在 VS Code 内直接切换已安装的 CLI Agent，每个 Agent 都保留自己的模型、模式、运行时和权限控制。
• 上下文感知提示词：自动附加工作区信息、当前文件、选区和诊断信息，并可在设置中控制上下文大小。
• CLI 配置系统：内置 Claude Code、Codex CLI、Gemini CLI、OpenCode、Goose 和 Aider 的执行配置，处理命令查找、参数构造、输入模式和后台服务生命周期。
• 后台服务支持：OpenCode 等支持持久会话的 Agent 可以保持后台服务运行，降低连续对话延迟。
• 编辑器动作命令：在编辑器右键菜单中解释选区、审查当前文件、生成测试或重构代码，并自动路由到当前 Agent。
• Git 提交信息生成：在 VS Code 源代码管理视图中，根据暂存区 diff 生成符合 Conventional Commits 的提交信息。
• 自定义 API 供应商：可配置自己的 API 地址、模型和密钥，并按 Agent 映射使用；密钥可通过 VS Code 设置同步或环境变量管理。
• 中英文界面：扩展命令、设置项和 Webview 均支持简体中文与英文。
• 供应商扩展桥接：可从侧边栏直接打开 OpenCode、Codex、Claude Code、Gemini CLI 等配套 VS Code 扩展。
• Token 统计：支持 Anthropic tokenizer 和 OpenAI cl100k 统计，并提供按供应商回退的估算能力。

使用要求

• VS Code 1.85+
• Node.js 18+
• 至少安装一个受支持的 CLI Agent：
  • OpenCode
  • Codex CLI
  • Claude Code
  • Gemini CLI
  • Goose
  • Aider

快速开始

1. 从 VS Code Marketplace 安装 Agents GUI。
2. 安装至少一个 CLI Agent，例如 OpenCode 或 Codex CLI。
3. 点击活动栏里的 Agents GUI 图标，或运行命令 Agents GUI：打开面板。
4. 在侧边栏顶部选择 Agent，然后输入任务开始使用。

扩展默认使用 OpenCode。你可以在设置项 agents-gui.defaultProvider 中修改默认 Agent。

Git 提交信息生成

Agents GUI 会接入 VS Code 原生源代码管理视图：

1. 先用 git add 把需要提交的文件加入暂存区。
2. 在源代码管理标题栏点击 Agents GUI 提交信息图标。
3. 扩展会只读取暂存区 diff，并结合输入框里已有的草稿提示生成提交信息。
4. 生成结果会流式写入提交信息输入框，完成后可直接提交。

提交信息默认遵循 VS Code 显示语言。中文界面下会默认生成中文提交信息，也可通过 agents-gui.commitMessage.language 手动切换。

常用配置

开发

# 安装依赖
npm install

# 构建扩展
npm run build

# 监听模式
npm run watch

# 运行测试
npm test

# 打包 VSIX
npm run package

项目结构

src/
├── extension.ts          # 扩展激活与命令注册
├── sidebarProvider.ts    # Webview Provider 与消息处理
├── cliManager.ts         # CLI 进程生命周期管理
├── cliProfiles.ts        # 内置 Agent 配置
├── cliPathResolver.ts    # CLI 命令查找与 Shell 集成
├── apiProviders.ts       # 自定义 API 供应商运行时
├── contextCollector.ts   # IDE 上下文收集
├── promptBuilder.ts      # 上下文感知提示词构建
├── outputFormatter.ts    # CLI 输出归一化
├── tokenCounter.ts       # Token 统计
├── localization.ts       # 运行时多语言
├── opencodeAgents.ts     # OpenCode Agent 发现
├── actionGuards.ts       # 动作前置条件
├── providerExtensions.ts # VS Code 扩展桥接
└── assistantTypes.ts     # 共享类型定义
media/
├── main.html             # Webview 布局
├── main.js               # Webview 逻辑
├── main.css              # Webview 样式
├── i18n.js               # Webview 多语言
└── icon.svg              # 扩展图标

支持的 CLI Agent

许可证

MIT