Agents GUI
trry-hub/agents-gui
Workbench unificado para múltiplos agentes de IA diretamente no VS Code
Ver no GitHubExtensão para VS Code que unifica múltiplos agentes de IA em um painel lateral único, com suporte a Claude Code, Gemini CLI, Codex, OpenCode, Goose e Aider. Oferece contexto inteligente, gerenciamento de configurações CLI, geração de commits Git e ações de editor integradas.
Instalação
npx convez-ai trry-hub/agents-gui1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Integrar e alternar entre múltiplos agentes de IA em um único painel lateral
- Gerar commits Git automáticos com mensagens padronizadas (Conventional Commits)
- Executar ações de editor com contexto automático (explicar código, revisar, gerar testes)
Veredito

Solução robusta para consolidar múltiplos agentes CLI em fluxo VS Code nativo, com integração Git e contexto sensível a arquivo. Bem estruturado, em versão inicial ativa, ideal para desenvolvedores que usam múltiplos agentes simultaneamente.
README
A tradução para o português deste README ainda está na fila.
Agents GUI
Agents GUI 是一个面向 VS Code 的多 Agent 工作台。它把 Claude Code、Codex CLI、Gemini CLI、OpenCode、Goose 和 Aider 等外部编码 Agent 汇聚到同一个侧边栏里,并提供上下文感知提示词、CLI 配置管理、自定义 API 供应商桥接和原生 Git 提交信息生成能力。
早期版本。 Agents GUI 正在围绕真实 VS Code 工作流持续迭代。
相关链接
- 官网 / 在线文档:https://agents-gui.pages.dev/
- VS Code Marketplace:https://marketplace.visualstudio.com/items?itemName=agents-gui.agents-gui
- GitHub 仓库:https://github.com/trry-hub/agents-gui
功能特性
- 多 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:
快速开始
- 从 VS Code Marketplace 安装 Agents GUI。
- 安装至少一个 CLI Agent,例如 OpenCode 或 Codex CLI。
- 点击活动栏里的 Agents GUI 图标,或运行命令
Agents GUI:打开面板。 - 在侧边栏顶部选择 Agent,然后输入任务开始使用。
扩展默认使用 OpenCode。你可以在设置项 agents-gui.defaultProvider 中修改默认 Agent。
Git 提交信息生成
Agents GUI 会接入 VS Code 原生源代码管理视图:
- 先用
git add把需要提交的文件加入暂存区。 - 在源代码管理标题栏点击 Agents GUI 提交信息图标。
- 扩展会只读取暂存区 diff,并结合输入框里已有的草稿提示生成提交信息。
- 生成结果会流式写入提交信息输入框,完成后可直接提交。
提交信息默认遵循 VS Code 显示语言。中文界面下会默认生成中文提交信息,也可通过 agents-gui.commitMessage.language 手动切换。要指定生成使用的 CLI,可在提交信息设置里选择具体 CLI,或将 agents-gui.commitMessage.provider 设为 ask 让每次生成前弹出选择。
常用配置
| 设置项 | 默认值 | 说明 |
|---|---|---|
agents-gui.defaultProvider | "opencode" | 编辑器命令默认使用的 AI 提供方 |
agents-gui.context.includeWorkspace | true | 是否附加工作区元数据 |
agents-gui.context.includeCurrentFile | true | 是否附加当前活动文件 |
agents-gui.context.includeSelection | true | 是否附加当前编辑器选区 |
agents-gui.context.includeDiagnostics | true | 是否附加当前文件诊断 |
agents-gui.context.maxFileChars | 12000 | 当前文件上下文最大字符数 |
agents-gui.context.maxSelectionChars | 8000 | 选区上下文最大字符数 |
agents-gui.context.maxDiagnostics | 12 | 附加诊断的最大数量 |
agents-gui.apiProviders.customProviders | [] | 自定义 API 供应商配置 |
agents-gui.apiProviders.defaultProviderId | "" | 全局默认自定义 API 供应商 |
agents-gui.apiProviders.agentProviderByCliId | {} | 每个 Agent 的自定义 API 供应商覆盖配置 |
agents-gui.home.visibleAgentIds | [] | 首页标题区展示的 Agent |
agents-gui.home.agentOrder | [] | 首页标题区 Agent 展示顺序 |
agents-gui.commitMessage.provider | "default" | Git 提交信息生成使用的 CLI,支持 default、ask 或 CLI 配置 ID |
agents-gui.commitMessage.language | "auto" | Git 提交信息语言,默认跟随 VS Code |
agents-gui.commitMessage.maxDiffChars | 60000 | 生成提交信息时附加的暂存区 diff 最大字符数 |
支持的 CLI Agent
| Agent | 配置 ID | 输入模式 | 后台服务 | Token 统计 |
|---|---|---|---|---|
| OpenCode | opencode | argument | 支持,端口范围 46100+ | Anthropic tokens |
| Codex CLI | codex | argument | 不支持 | tiktoken cl100k |
| Claude Code | claude | argument | 不支持 | Anthropic tokens |
| Gemini CLI | gemini | argument | 不支持 | 暂无 |
| Goose | goose | stdin | 不支持 | 暂无 |
| Aider | aider | argument | 不支持 | tiktoken cl100k |
反馈与支持
许可证
MIT