AgentHub

把 AI Agent 当队友一样拉进群聊。和真人好友、AI Builder、AI Reviewer 在同一个 IM 里聊天协作——消息就是任务流，聊天就是工作台。

English · 官网 · 文档 · API

产品定位

AgentHub 让你像在 IM 群聊里协作一样，把真人好友、Builder、Reviewer、Researcher、Deployer 等 AI Agent 放进同一个项目会话，围绕代码、文档、Diff、Preview、Approval 和产物协同工作。

核心特性

• IM 形态协作 — 单聊、群聊、@Agent，在同一条任务流里完成
• 多 Runtime 调度 — Claude Code、Codex、OpenCode 通过统一 Adapter 接入
• Diff / Preview / Approval — 代码变更内联展示，审批流可控
• 三端原生 — Tauri Desktop + Web + Expo React Native Mobile（Mobile 装配中，见 CHANGELOG Wave5/6）
• Hub-Edge 分布式 — 本地执行不依赖 Hub；Hub 提供多端同步、远程查看和审计

技术栈

层	技术
Desktop	Tauri 2 · React 19 · TypeScript · Vite
Web	React 19 · TypeScript · Vite
Mobile	React Native · Expo
后端	Go · PostgreSQL · Redis · SQLite

仓库结构

目录	说明
app/web	浏览器工作台
app/desktop	Tauri Desktop 工作台
app/mobile-rn	Expo / React Native Mobile
app/shared	共享 UI 组件、类型、transcript 逻辑
hub-server	Hub API：身份、会话、项目、任务、消息、审批
edge-server	本地执行节点：CLI Adapter、SQLite、事件回放
api	OpenAPI 与 WebSocket 事件合同
docs	架构、路线图、设计文档

快速开始

最小本地启动路径（5 步）。需要 Docker、Go 1.26+、Node 22+/corepack、pnpm 10+。

cp .env.example .env                        # 1. 复制开发环境变量（含默认 dev 密码）
docker compose up -d postgres redis         # 2. 起基础设施（PG16 + Redis7，仅绑 127.0.0.1）
cd hub-server && go run ./cmd/server-hub    # 3. 起 Hub Server（自动跑迁移，API 在 :8080）
cd ../app && corepack pnpm install          # 4. 装前端依赖
pnpm dev                                    # 5. 起 Desktop Vite（:5173）；web 用 pnpm dev:web

完整启动路径、OIDC 接入、Edge Server 调试见 docs/developer-quickstart.md；生产部署与必填变量见 docs/architecture/05-deployment.md。

开发

入口	说明
docs/developer-quickstart.md	本地最短启动路径
docs/architecture.md	架构总览与模块索引
docs/README.md	文档导航
AGENTS.md	项目规则 SSOT（分支、红线、证据等级）

贡献

欢迎提交 Issue 和 Pull Request。详情见 CONTRIBUTING.md。

License

Apache-2.0. See LICENSE.