AgentX

定位与解决的问题#

开发者在使用 Claude Code、Codex、Copilot 等多种 AI 编程 Agent 时，面临在不同 CLI 窗口或 IDE 插件之间频繁切换的割裂体验。AgentX 定位为桌面端客户端和交互聚合层，本身不包含大模型推理能力，而是作为前端通过 ACP 协议对接各类本地或远程 Agent 后端，同时支持 OpenAI 兼容 API 直连，并通过 MCP 协议为 Agent 动态扩展工具链。

核心能力#

Agent 连接与管理#

• 基于 ACP 协议并发连接多个 Agent，支持 Claude、Codex、Kimi Code、Qwen、Qoder、OpenCode、Gemini、AugmentCode、Iflow 等 10+ 种主流 Agent
• 支持 OpenAI 兼容 API 的直连模型配置
• 支持自定义 Prompt 命令模板

交互与可视化#

• 实时流式响应展示
• 原生支持思考块（thinking blocks）与工具调用过程可视化查看器
• 多会话组织与 JSONL 格式自动保存

开发环境集成#

• 内置代码编辑器：支持 LSP、Tree-sitter 语法高亮与自动补全
• 内置集成终端：可在应用内直接执行命令
• MCP 工具链配置：支持 stdio/HTTP/SSE 三种传输协议，可挂载文件系统、GitHub 等外部工具
• 内置 Git worktree 管理

桌面体验#

• 基于 GPUI 的 GPU 加速渲染
• 可拖拽自定义 Dock 面板布局（状态持久化）
• 亮色/暗色主题及自定义颜色
• 系统托盘常驻
• 内置版本检查与自动更新
• 中英双语国际化

架构要点#

采用 Rust Workspace 模块化架构，核心域拆分为：agentx-types（核心类型定义）、agentx-event-bus（事件总线）、agentx-agent（Agent 通信层）、agentx-services（服务层）、agentx-acp-ui（ACP 协议 UI 组件）及 git-worktree-manager。

底层渲染采用 Zed Industries 的 GPUI 框架，搭配自建的 gpui-component（UI 组件库）和 gpui-term（终端组件）。异步运行时使用 Tokio，HTTP 客户端使用 reqwest（Zed 定制 fork），序列化使用 serde/serde_json。

Release 模式启用极致体积优化（opt-level = "z"、lto = "fat"、codegen-units = 1），Dev 模式使用 opt-level = 1 平衡编译耗时。

安装与上手#

从 GitHub Releases 下载对应平台安装包：

• macOS：下载 agentx-macos.dmg，拖拽至 Applications
• Windows：运行 agentx-windows.msi 安装，或使用 agentx-windows.exe 便携版
• Linux：执行 sudo dpkg -i agentx-linux.deb 安装，或解压 agentx-linux.tar.gz 便携版（需预先安装 Vulkan、GTK3 等系统依赖）

上手路径：启动应用 → Settings → MCP Config → 在配置文件中设定 agent_servers（Agent 启动命令）或 models（直连 API）及 mcpServers（外部工具）→ 创建会话并开始对话。

配置能力#

全局通过 config.json 管理所有连接与扩展行为：

• agent_servers：指定启动 Agent 的 command、args 及环境变量
• models：配置第三方 API 的 provider、base_url、api_key 和 model_name
• mcpServers：配置 stdio/HTTP/SSE 三种传输协议的工具服务器
• commands：通过 template 字段自定义快捷 Prompt

调试模式：RUST_LOG=info cargo run。删除 docks-agentx.json 可重置面板布局；布局文件存于 agentx/ 目录，会话数据存于 sessions/ 目录。

当前版本：v0.3.1，开源协议：Apache-2.0。