# AgentHub

[Tiếng Việt](README.md) · **English**

A dashboard that runs on your machine to watch and drive your Claude Code (and
Codex) sessions from the browser.

| Section | Tiếng Việt |
| --- | --- |
| [Requirements](#requirements) | [Yêu cầu](README.md#requirements) |
| [Option 1 — Through Claude Code](#install-claude-code) | [Cách 1 — Cài qua Claude Code](README.md#install-claude-code) |
| [Option 2 — From a terminal](#install-terminal) | [Cách 2 — Cài bằng terminal](README.md#install-terminal) |
| [More docs](#more-docs) | [Tài liệu thêm](README.md#more-docs) |

<a id="requirements"></a>

## Requirements

- **Node.js ≥ 22.5**
- **git**
- **tmux**

To install them:

- Ubuntu: `sudo apt install git tmux` (get Node.js ≥ 22.5 from <https://nodejs.org>)
- macOS: `brew install node git tmux`

<a id="install-claude-code"></a>

## Option 1 — Install through Claude Code (recommended)

Send **each line on its own** straight into the Claude Code chat:

```
/plugin marketplace add https://git.smartgift.io.vn/Smartgift-AI/AgentHub.git
```

```
/plugin install agenthub@agenthub
```

```
/agenthub:agenthub-open
```

The last one prints the dashboard's address (by default <http://localhost:4820>) —
open it in the browser and you are done.

Something wrong? Send `/agenthub:agenthub-doctor` to check and fix it.
To update to a new version: `/agenthub:agenthub-update`.
Not using it? Quit so nothing runs in the background: **Settings → System → Quit**,
or `agenthub stop` — opening Claude Code no longer starts it; `agenthub start` does.
AgentHub's icon beside the clock (top bar / menu bar / notification area) offers
**Open**, **Quit** and **Start AgentHub** too; hide it from its menu or in **Settings → System**.

<a id="install-terminal"></a>

## Option 2 — Install from a terminal (without Claude Code)

Run these in a terminal, one after another:

```bash
git clone https://git.smartgift.io.vn/Smartgift-AI/AgentHub.git
cd AgentHub
npm run setup      # install the dependencies + the agenthub command
npm run build      # build the UI
npm start          # run the dashboard
```

Open <http://localhost:4820> in the browser.

`npm start` stops when the terminal closes. To have the dashboard start every time
the machine boots:

```bash
agenthub service install
```

> ⚠️ Pick **only one** of the two options. With both installed, every event is
> counted twice.

<a id="more-docs"></a>

## More docs

- Vietnamese README: [README.md](README.md)
- The full feature overview: [docs/OVERVIEW.md](docs/OVERVIEW.md) ·
  Tiếng Việt: [docs/OVERVIEW.vi.md](docs/OVERVIEW.vi.md)
- Detailed install, troubleshooting: [INSTALL.md](INSTALL.md)
- Plugin: [docs/PLUGINS.md](docs/PLUGINS.md)
- The `agenthub` command: [docs/CLI.md](docs/CLI.md)

Internal build — all rights reserved.