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（Desktop/Web 主线；Mobile 是装配中的 fixture/边界验证 lane，非 release candidate —— 发布链路的 build-mobile 受 RELEASE_MOBILE_ENABLED 门控、默认关闭）
• 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 逻辑
app/workbench	端级工作台壳（@agenthub/workbench，依赖方向 workbench → shared 单向）
hub-server	Hub API：身份、会话、项目、任务、消息、审批
edge-server	本地执行节点：CLI Adapter、SQLite、事件回放
pkg	Hub/Edge 共享的 Go 包（errcode、jwtutil、testkit 等；独立 module，经根 go.work 联编）
api	OpenAPI 与 WebSocket 事件合同
docs	稳定架构、治理与设计文档；交付进度与路线图在 GitHub issues

快速开始

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

终端 A（基础设施与 Hub）：

cp .env.example .env
secret="$(openssl rand -hex 32)"
sed -i.bak "s/^AGENTHUB_JWT_SECRET=.*/AGENTHUB_JWT_SECRET=$secret/" .env && rm -f .env.bak
set -a; . ./.env; set +a                   # 1. 复制配置、生成开发 secret 并导出给 Hub 进程
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）

终端 B（前端）：

cd app && corepack pnpm install             # 4. 装前端依赖
corepack pnpm dev                           # 5. 起 Desktop Vite（:5173）；web 用 corepack pnpm dev:web

.env.example 不提供可复用 JWT secret；Windows PowerShell 命令、完整启动路径、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.