AgentHub

把 Claude Code 与 Codex 留在自己的电脑上，把控制权带到任何设备。

面向手机、Web、桌面端和自动化脚本的开源 AI 编码代理控制中心。

AgentHub 在你的电脑上启动并管理 Claude Code 或 Codex，通过端到端加密把会话状态同步到手机、浏览器或桌面客户端。你可以离开工位后继续对话、批准工具调用、检查 Git 变更、浏览机器文件，或者从另一台终端自动化控制会话。

为什么是 AgentHub

• 代理仍在本机运行：代码、工具链和工作目录不必迁移到陌生的远程执行环境。
• 真正的跨设备接管：在手机、Web、桌面端查看在线机器，创建、恢复、接管或停止会话。
• 专注两个生产运行时：当前明确支持 Claude Code 与 Codex，不提供无法维护的“万能 Provider”抽象。
• 端到端加密同步：服务端负责认证、转发和持久化，加密域与密钥材料由客户端管理。
• 不仅是聊天窗口：内置项目工作台、权限审批、Markdown/Mermaid、Git、文件、Artifacts 与用量视图。
• 可自托管、可自动化：Server 支持标准部署和轻量 standalone 模式，agenthub-agent 可从脚本远程控制机器与会话。

产品界面

以下展示来自 Android 真机页面。隐私相关的主机名、工作路径和进程号已替换为安全示例；页面内容只使用现有功能与安全演示数据。所有原始截图均为 1080 × 2376，下方按 50% 尺寸统一处理并以四台设备为一组呈现。

第一行展示浅色主题，第二行展示深色主题；每组四个页面使用完全一致的画布、设备尺寸和间距。

3 分钟开始

1. 准备本机环境

需要 Node.js 20 或更高版本，并至少安装一个受支持的官方 CLI：

claude --version
codex --version

2. 安装 AgentHub CLI

npm install -g @artsum/agenthub

3. 登录并接入机器

agenthub auth login
agenthub auth status
agenthub daemon status

首次登录会通过二维码绑定账号，并自动检查当前平台的 daemon 自启动与运行状态。需要手动管理常驻服务时可运行：

agenthub daemon install
agenthub daemon list

4. 启动编码代理

agenthub              # 默认启动 Claude Code
agenthub claude       # 显式启动 Claude Code
agenthub codex        # 启动 Codex

在手机、Web 或桌面客户端登录同一账号，即可继续会话。更完整的登录、凭据和远程恢复说明见快速开始。

核心能力

场景	能力
会话工作台	按机器和项目组织任务，支持最近会话、高级恢复、官方会话接管、归档与删除。
Claude Code / Codex	本地或远程创建会话，处理权限请求；Codex 支持动态模型目录、steer、fork 与官方线程恢复。
机器与文件	查看在线机器、远程 RPC、目录浏览、分块下载、暂停重试与断线续传。
开发上下文	在会话内查看 Markdown、Mermaid、工具调用、Git status/diff/log、文件内容与 Artifacts。
加密数据	端到端加密会话、托管凭据、用户 KV，以及可设置有效期和随时撤销的加密文本分享。
跨平台常驻	Linux systemd、macOS LaunchAgent、Windows 登录计划任务，以及带检查和回滚的 CLI 自更新。
自动化控制	使用 agenthub-agent 列出机器与会话，执行 spawn、send、history、wait 和 stop。

完整的能力、实现入口和专题文档对应关系见功能与代码映射。

工作原理

flowchart LR
    A["手机 / Web / 桌面端"] <-->|"端到端加密同步"| S["AgentHub Server"]
    R["agenthub-agent / 自动化脚本"] -->|"账号与机器作用域 RPC"| S
    S <-->|"实时事件与远程控制"| D["本机 agenthub daemon"]
    D --> C["Claude Code"]
    D --> X["Codex"]
    D --> P["你的项目与工具链"]

Loading

查看 AgentHub 完整架构图

• 客户端保存账号密钥和 UI 状态，拉取快照并接收实时更新。
• Server负责认证、路由、排序、密文持久化和多端广播。
• daemon / runner在目标机器上启动代理、执行 RPC，并收敛会话生命周期。

详细的数据流、协议和信任边界见系统架构、实时同步与 RPC和端到端加密。

自托管

AgentHub Server 提供两种部署形态：

• 标准部署：PostgreSQL、Redis、S3 兼容对象存储，适合长期运行和横向扩展。
• Standalone：PGlite 与本地文件存储，适合个人实例和低门槛试用。

生产环境变量、迁移、反向代理、容器和 systemd 配置见部署指南。安全问题请按照安全政策私下报告。

从源码开发

这是一个 pnpm monorepo：

组件	路径	说明
App	packages/agenthub-app	Expo / React Native / Web / Tauri 客户端。
CLI	packages/agenthub-cli	agenthub 命令、daemon、runner 生命周期和远程 RPC。
Server	packages/agenthub-server	Fastify、Socket.IO、Prisma/PGlite、对象存储和同步 API。
Wire	packages/agenthub-wire	多端共享 Zod schema 与 TypeScript 协议类型。
Agent	packages/agenthub-agent	独立远程控制 CLI。

npx -y pnpm@10.11.0 install
npx -y pnpm@10.11.0 check
npx -y pnpm@10.11.0 web:contract:test

开发环境、测试入口和 Android 构建方式见本地开发环境与贡献指南。

文档

• 文档索引
• 快速开始
• 项目当前状态
• 功能与代码映射
• 系统架构
• CLI 与 daemon
• App 架构
• Server 架构
• 部署指南
• 开源发布准备
• 隐私政策
• 安全政策

贡献与许可证

欢迎提交 Issue 和 Pull Request。开始前请先阅读贡献指南。

AgentHub 的新增贡献以 Apache License 2.0 发布。项目基于 Happy 演进，其原始 MIT 许可证和版权通知继续保留在 LICENSE-MIT 与 NOTICE 中。