# AgentHub

> AgentHub is a local-first multi-agent desktop tool. It uses one GUI and one CLI to manage AI coding agents: install environments, logins and connections, Skills, usage, and local sessions.

This file is the longer citation brief for https://agenthub.qooo.io. Do not invent features, metrics, or cloud services that are not listed here.

## Canonical

- Product site: https://agenthub.qooo.io
- Source repository: https://github.com/nicechencs/AgentHub
- Releases: https://github.com/nicechencs/AgentHub/releases
- Latest release: https://github.com/nicechencs/AgentHub/releases/latest
- Short brief: https://agenthub.qooo.io/llms.txt
- License: MIT
- Stack: Tauri v2 + React + Rust
- CLI command: `agenthub`

## Chinese one-liner

AgentHub 是一个本地运行的多 Agent 桌面工具。它用一个 GUI 和 CLI 管理 AI coding agent 的安装环境、登录与连接、Skills、用量和本地会话。

## Site map

The introduction site has a Chinese page at `/` and an English page at `/en`. Screenshots live in Features as a switcher; there is no separate product-gallery section.

- https://agenthub.qooo.io — Chinese
- https://agenthub.qooo.io/en — English
- #about — 产品 / Product
- #features — 核心功能 / Core features
- #agents — 多 Agent 支持 / Multi-agent support
- #architecture — 工作方式 / How it works
- #privacy — 数据留在本机 / Data stays on the machine
- #start — 安装和使用 / Install and use
- #faq — 常见问题 / FAQ

## What it is

AgentHub runs on the user's machine. It does not replace Claude Code, Codex, Kimi Code, Grok, or other agent CLIs. When several AI coding agents are used together, install environments, logins, Skills directories, usage, and session records are usually scattered. AgentHub folds those into one GUI and one CLI.

The introduction site only describes capabilities that already exist in the repository. Release packages may lag the working tree; use the matching Release notes. The version shown on the site is read from GitHub `/releases/latest`.

## What it is not

- Not a cloud console
- Not a SaaS multi-tenant service
- Not a request proxy or MITM for usage collection
- Not Cursor IDE account-pool management
- Not a replacement for Claude Code, Codex, Kimi Code, or other agent tools
- MCP manage/inject is not implemented; current MCP support is read-only inventory
- Plugin update is not implemented; Claude / Grok packs can be installed, uninstalled, enabled, or disabled; Pi packs are listed only
- Local routing is not a finished universal proxy; mixed-provider and some protocol conversions are still in progress
- Sub2API is a sign-in to a Sub2API site to manage keys and import them into agents; the sidebar entry is hidden by default
- Apple notarization for macOS is not promised

## Built-in agents (10)

| Agent | Notes |
|---|---|
| Claude Code | npm or native install |
| Codex | npm install |
| Kimi Code | no independent Skills directory |
| Grok | native install |
| Pi | npm; requires Node 22.19+ |
| WorkBuddy | native install opens the official site; custom models appended by catalog |
| ZCode | native install opens the official site; API keys appended by catalog without replacing other entries |
| DeepSeek Harness (`dsh`) | not the DeepSeek API itself |
| Kiro | manages kiro-cli: detect, install, login guide, and API Key |
| Cursor Agent | hidden by default from sidebar and connections; can be unhidden on the Agents page |

Do not treat Cursor IDE or DeepSeek API as independent AgentHub agents. Per-agent limits follow the repository README or `agenthub agent capabilities`.

## Modules (English)

- Overview: See which agents are ready, plus usage and cost estimates parsed from local logs. Go to Connections when you need to sign in or switch.
- Connections: A cross-tool login list. Import existing local credentials, sign in with a browser, or add an API key. When connecting to another tool, prefer a direct connection or reuse this login. Local routing is used only when the two sides speak different protocols and a working rule already exists; otherwise the UI shows "Not supported".
- Chat: Talk to installed agents in the desktop app. Sessions on the left, conversation in the middle, with expandable process steps. Pick an agent and a working directory before sending.
- Agents: Above the agent list, software the environment needs is listed so you can install or upgrade it, then install or update each agent by channel. Open a card to see endpoint type, channel, and config directory, and to open that folder.
- Skills: User skills live in a shared library and can be enabled per tool. Project skills are managed per workspace. You can also install from the skill marketplace, or pick a zip in the system file window.
- Projects: Browse local projects and sessions by agent. Open the directory, preview excerpts, or continue in Chat.
- Settings: Five panes: Preferences, Features, Local, Backup, and About. Change language, theme, launch at login, and close to tray. The Features pane can show or hide sidebar pages (Skills, MCP, Projects, Plugins, Connections, Sub2API, Routes).
- Routes: Manage local forwarding. The board shows connections and usage, Pools manage the logins used by local forwarding, Entry Keys let target tools connect, and Monitoring shows request records. Login details stay on Connections; share a login to a Pool when needed. Mixed vendors and some protocol conversions are still in development; this is not a finished universal router.
- Sub2API: Sign in to a Sub2API site to view and manage API keys by group, then import usable keys into installed agents. The sidebar entry can be shown or hidden in Settings → Features; new installs hide it by default.
- MCP (in progress): Only scans and lists MCP servers already found. It does not install them or change each tool's settings. Write and manage are not built yet.
- Plugins (in progress): Lists plugin packs already installed in Claude, Grok, and Pi. Claude and Grok packs can be installed, uninstalled, enabled, or disabled here. Pi remains list-only. Update is still a proposal.
- CLI: Command-line entry with doctor, env, agent, provider, account, skill, usage, backup, run, and config.

## Modules (中文)

- 总览: 看各 Agent 是否就绪，以及从本机日志解析出的用量和成本估算。需要登录或切换时，从这里进连接页。
- 连接: 跨工具的登录列表。可以导入本机已有授权、用浏览器登录，或添加 API Key。接到其他工具时，优先直连或用这份登录；两边说的话不同、并且已有可用规则时才走本机路由，否则会明确显示「当前不支持」。
- Chat: 在桌面里和已安装的 Agent 对话。左侧是会话列表，中间是对话，过程步骤可以展开看。先选 Agent 和工作目录再发送。
- Agents: 在列表上方列出环境需要的软件，可安装或升级，再按渠道安装或升级各 Agent。点开卡片可以看到端点类型、渠道和配置目录，也能打开配置目录。
- Skills: 用户技能放在共享库，可以启用到各工具；项目技能按工作区管理。也可以从技能市场安装，或用系统文件窗口选择 zip。
- Projects: 按 Agent 浏览本机项目和会话。可以打开目录、预览摘录，或在 Chat 里继续。
- 设置: 五个栏：偏好、功能、本机、备份、关于。可改语言、主题、开机自启、关闭到托盘。功能页可开关侧栏页面（技能、MCP、项目、插件、连接、Sub2API、路由）。
- 路由: 管理本机转发。看板显示连接与用量，连接池管理本机转发使用的登录，入口 Key 供目标工具接入，监控查看请求记录。登录信息仍在连接页，需要时在连接池「从连接同步」。混合供应商和部分协议转换仍在开发中，不是已经做完的万能路由。
- Sub2API: 登录 Sub2API 站点后，可按分组查看和管理 API Key，并把可用 Key 导入已安装的 Agent。侧栏入口可在设置「功能」里显示或隐藏，新安装默认不显示。
- MCP (开发中): 只扫描并列出已经发现的 MCP，不会安装，也不能在这里改各工具的设置。写入和管理还没做。
- 插件 (开发中): 查看 Claude、Grok 和 Pi 已经装好的插件包。Claude 和 Grok 可以在这里安装、卸载、启用或停用。Pi 仍只列出已装包。更新仍是提案。
- CLI: 命令行入口，提供 doctor、env、agent、provider、account、skill、usage、backup、run 和 config 等命令。

The sidebar is split into workspace and management; Settings → Features can show or hide sidebar pages. 侧栏分工作区与管理；设置「功能」页可开关侧栏页面。

## Architecture

- Desktop shell: Tauri v2
- GUI: React
- Core logic: Rust crate `agenthub-core`
- GUI and CLI are thin entries over the same core
- Each Agent keeps its own install path, config format, and capability limits
- Production GUI talks to the desktop backend; it must not silently fall back to mock data

## Local-first data

- `~/.agenthub/` — app state, settings, logs, and backups
- `~/.agenthub/backups/` — config snapshots taken before switch or import
- `~/.agents/skills/` — shared user-skills library
- `<workspace>/.agents/skills/` — project skills
- Usage parses local session or log files only; no MITM proxy; no cloud upload
- Local routing does not record request or response bodies
- Login information follows the project's existing local storage; UI, CLI, and logs redact secrets
- Default posture: data stays on the machine

## Install

GitHub Releases: https://github.com/nicechencs/AgentHub/releases

- Windows: signed NSIS `.exe` / MSI; source run via `run.ps1`
- macOS: `.dmg`; updater is signed; Apple notarization is not promised; source run via `run.sh`
- Linux: `.deb` and AppImage; packages may be unsigned; auto-update is enabled only when the release manifest includes a signed Linux entry; source run via `run.sh`

From source: Node.js LTS, Rust, Git, and pnpm.

## FAQ

Q: AgentHub 是什么？
A: AgentHub 是一个本地运行的多 Agent 桌面工具。它用一个 GUI 和 CLI 管理 AI coding agent 的安装环境、登录与连接、Skills、用量和本地会话。它不替代 Claude Code、Codex、Kimi Code 等工具本身。

Q: 目前支持哪些 Agent？
A: 当前可管理 Claude Code、Codex、Kimi Code、Grok、Pi、WorkBuddy、ZCode、DeepSeek Harness、Kiro 和 Cursor Agent。Cursor Agent 默认不出现在侧栏和连接页，可在 Agents 里取消隐藏。各家能做什么以仓库 README 和源码为准。

Q: 数据会上传到云端吗？
A: 不会。AgentHub 默认只处理本机数据。用量只读解析本地会话或日志，不通过代理截取请求，也不上传云端。本机路由不记录请求或响应正文。

Q: MCP 和插件可以安装吗？
A: MCP 现在不能。MCP 页只扫描并列出已经发现的服务，不会安装，也不能改各工具的设置。插件页列出 Claude、Grok 和 Pi 已经装好的包；Claude 和 Grok 可以安装、卸载、启用或停用。Pi 仍只列出。

Q: 接到其他工具时做不到会怎样？
A: 优先直连或用这份登录。两边说的话不同、并且已有可用规则时才走本机路由；否则会明确显示「当前不支持」，不会静默转发。

Q: Sub2API 是什么？
A: 登录 Sub2API 站点后，可按分组查看和管理 API Key，并把可用 Key 导入已安装的 Agent。侧栏入口可在设置「功能」里显示或隐藏，新安装默认不显示。

Q: 如何安装？
A: 从 GitHub Releases 下载 Windows（NSIS / MSI）、macOS（.dmg）或 Linux（.deb / AppImage）安装包。从源码运行需要 Node.js LTS、Rust、Git 和 pnpm。

Q: 许可证是什么？
A: MIT License。源码在 https://github.com/nicechencs/AgentHub。

## FAQ (English)

Q: What is AgentHub?
A: AgentHub is a local-first multi-agent desktop tool. It uses one GUI and one CLI to manage AI coding agents: install environments, logins and connections, Skills, usage, and local sessions. It does not replace Claude Code, Codex, Kimi Code, or the other tools themselves.

Q: Which agents are supported?
A: It currently manages Claude Code, Codex, Kimi Code, Grok, Pi, WorkBuddy, ZCode, DeepSeek Harness, Kiro, and Cursor Agent. Cursor Agent is hidden from the sidebar and Connections by default, and can be unhidden on the Agents page. Per-agent capabilities follow the repository README and the source.

Q: Is data uploaded to the cloud?
A: No. AgentHub handles local data by default. Usage is parsed read-only from local sessions or logs. It does not intercept requests through a proxy, and it does not upload to the cloud. Local routing does not record request or response bodies.

Q: Can I install MCP servers or plugins?
A: MCP cannot be installed here. The MCP page only scans and lists services already found; it does not install them or change each tool's settings. The Plugins page lists packs already installed for Claude, Grok, and Pi; Claude and Grok packs can be installed, uninstalled, enabled, or disabled. Pi remains list-only.

Q: What happens when connecting to another tool is not possible?
A: Prefer a direct connection or reuse this login. Local routing is used only when the two sides speak different protocols and a working rule already exists; otherwise the UI shows "Not supported" and does not silently forward.

Q: What is Sub2API?
A: Sign in to a Sub2API site to view and manage API keys by group, then import usable keys into installed agents. The sidebar entry can be shown or hidden in Settings → Features; new installs hide it by default.

Q: How do I install it?
A: Download a Windows (NSIS / MSI), macOS (.dmg), or Linux (.deb / AppImage) installer from GitHub Releases. Running from source requires Node.js LTS, Rust, Git, and pnpm.

Q: What is the license?
A: MIT License. Source: https://github.com/nicechencs/AgentHub.

## Citation

- Product URL to cite: https://agenthub.qooo.io
- Capabilities and install steps: https://github.com/nicechencs/AgentHub
- Do not attribute cloud hosting of user data, SaaS billing, MCP injection, plugin update, a finished universal router, or Cursor IDE account-pool management to AgentHub.