# AgentHub

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

Dashboard chạy trên máy anh chị để theo dõi và điều khiển các phiên Claude Code
(và Codex) ngay trên trình duyệt.

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

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

## Yêu cầu

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

Cài:

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

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

## Cách 1 — Cài qua Claude Code (khuyên dùng)

Anh chị hãy gửi **riêng từng dòng** sau thẳng vào khung chat Claude Code:

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

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

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

Dòng cuối in ra địa chỉ dashboard (mặc định <http://localhost:4820>) — mở nó
trên trình duyệt là xong.

Gặp lỗi thì gửi `/agenthub:agenthub-doctor` để tự kiểm tra và sửa.
Cập nhật bản mới: `/agenthub:agenthub-update`.
Không dùng thì tắt hẳn cho khỏi chạy ngầm: **Settings → Hệ thống → Thoát**, hoặc
`agenthub stop` — mở Claude Code sẽ không tự bật lại; bật lại bằng `agenthub start`.
Gỡ hẳn khỏi máy: **Settings → Hệ thống → Gỡ cài đặt**, hoặc `agenthub uninstall`
(chỉ liệt kê) rồi `agenthub uninstall --yes` — xoá cả database của AgentHub; các cuộc
trò chuyện của Claude Code/Codex, worktree và repository của bạn được giữ lại.
Icon AgentHub cạnh đồng hồ (thanh trên cùng / menu bar / khay hệ thống) cũng có
**Open**, **Quit** và **Start AgentHub**; ẩn nó trong menu của icon hoặc ở **Settings → Hệ thống**.

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

## Cách 2 — Cài bằng terminal (không qua Claude Code)

Chạy lần lượt trong terminal:

```bash
git clone https://git.smartgift.io.vn/Smartgift-AI/AgentHub.git
cd AgentHub
npm run setup      # cài thư viện + lệnh agenthub
npm run build      # build giao diện
npm start          # chạy dashboard
```

Mở <http://localhost:4820> trên trình duyệt.

`npm start` tắt khi đóng terminal. Muốn dashboard tự chạy mỗi lần bật máy:

```bash
agenthub service install
```

> ⚠️ Chỉ chọn **một** trong hai cách. Cài cả hai thì mỗi sự kiện bị đếm hai lần.

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

## Tài liệu thêm

- README tiếng Anh: [README.en.md](README.en.md)
- Giới thiệu đầy đủ tính năng: [docs/OVERVIEW.vi.md](docs/OVERVIEW.vi.md) ·
  English: [docs/OVERVIEW.md](docs/OVERVIEW.md)
- Cài đặt chi tiết, xử lý sự cố: [INSTALL.md](INSTALL.md)
- Plugin: [docs/PLUGINS.md](docs/PLUGINS.md)
- Lệnh `agenthub`: [docs/CLI.md](docs/CLI.md)

Internal build — all rights reserved.