An admin sets a default spend quota on the Users page and overrides it per
user (Edit user → Spend quota: default / no limit / their own), in dollars
per local day or per sliding 5 hours. Spend is the users page's own
hourlyTokenRows + calculateCost over the sessions a user owns.
Over the quota, until it opens again:
- spawnRun refuses every start/resume/home prompt with EQUOTA (429);
- a minute sweep writes each pane's AGENTHUB_QUOTA_FILE (host: data dir,
member: handoff dir via write-as) and hook-handler.js exits 2 on
UserPromptSubmit from that file alone (Claude Code, Codex with trusted
hooks) — fail-open, never asks the dashboard, never for Antigravity;
- a member's omp on the shared login loses its gateway key (clientsFor);
- panes no hook can stop (Antigravity, Cursor, Codex without trusted
hooks, omp on its own login) are ended.
GET /api/me/quota feeds a "Quota N%" chip in the status bar.
New: server/lib/user-quota.js, user_quotas table, PUT /api/users/quota-default,
PATCH /api/users/:id {quota}, docs in SERVER-MODE.md § Spend quotas.
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.