nntrivi2001
4a665da79e
- /ws-pty carries the dashboard token like /ws (the terminal never attached with DASHBOARD_TOKEN set), and so does everything that cannot send the header: images, downloads, exports, drops (withToken/tokenHeader). A refused upgrade answers 401/403 and is logged and counted by reason. - The browser asks for a missing or wrong token (401 EUNAUTHORIZED) and takes ?token= from the link agenthub start prints, dropping it from the URL. - The CLI sends the token (DASHBOARD_TOKEN, else the one the running server publishes 0600 in <data dir>/runtime/dashboard-token); MCP and statusline read the same file. - DASHBOARD_HOST takes a list, and 127.0.0.1 is always listened on too, so a LAN-only bind keeps hooks and the CLI working. - agenthub start --host/--allowed-hosts/--token are saved in <data dir>/network.json for every later start; a wide bind gets a token; every reachable URL is printed. - tmux < 3.7 is an amber, once-per-version notice that says only the pane scrollbar is missing, with a ~/.local build instead of sudo make install. - INSTALL: PATH belongs in ~/.profile for sudo -iu/ssh; WSL mirrored notes.
AgentHub
Tiếng Việt · 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 | Yêu cầu |
| Option 1 — Through Claude Code | Cách 1 — Cài qua Claude Code |
| Option 2 — From a terminal | Cách 2 — Cài bằng terminal |
| More docs | Tài liệu thêm |
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
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.
Option 2 — Install from a terminal (without Claude Code)
Run these in a terminal, one after another:
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:
agenthub service install
⚠️ Pick only one of the two options. With both installed, every event is counted twice.
More docs
- Vietnamese README: README.md
- The full feature overview: docs/OVERVIEW.md · Tiếng Việt: docs/OVERVIEW.vi.md
- Detailed install, troubleshooting: INSTALL.md
- Plugin: docs/PLUGINS.md
- The
agenthubcommand: docs/CLI.md
Internal build — all rights reserved.