nntrivi2001
c946b73d11
Remote clients (docs/plans/remote-clients/README.md, B1–B3 for the Claude pool): - server/hub/ holds the hub-only code (devices, remote sessions, upload ingest, LAN gateway), required only in server mode; hub-boundary.test.js keeps local code from importing it. - A local install enrolls with `agenthub remote login` or Settings → AI tools → Company hub; the "Company account" AI Proxy (reserved name agenthub.company) sends a session through the hub's gateway, which adds a pool account's token — no credential reaches the machine. Only those sessions are uploaded, hourly and at their end; secret-shaped strings are redacted on the client. - Gateway refuses: unknown device (401), a message without a session id, an unregistered session under AGENTHUB_REMOTE_GATE=block, a user over quota (EQUOTA), a purged session (410). Device tokens 90 days, conversations 30. - New alert rule type remote_unmonitored: a company-account session its device never registered; a late registration clears the flag instead. - The hub imports a session once per upload round (chunks carry `more`), not once per chunk. Artifacts: - Share an artifact with chosen people (artifact_shares, PATCH sharedWith, GET /api/artifacts/people) besides everyone; a "Shared with you" tab. Only the owner or an admin sees or edits who it is shared with; audited. - Folders: each account's own arrangement (agenthub.artifacts.folders pref). - A claude.ai page keeps a copy viewable without the publishing account: its HTML file (and supporting files) snapshotted at publish, or the copy Claude saves for a Doc / Slides / Design in artifacts-export/ (a synchronous PostToolUse hint hook, scripts/artifact-export-hint.js, admin switch), attached to the page at Stop. Viewed in HtmlFrame's sandbox, Markdown, or pdf.js (pdfjs-dist 6.4.299, legacy build, loaded only for a PDF). Fixes: - tmux: a cached /proc/<pid>/exe of an exited server falls back to PATH's tmux (stop the last pane, start again within 10 s failed with ENOENT). - shelves: a shelf restores beside changes in other files. - chat: a finished reply ends the turn even with no hook at all. - Settings → AI tools: profile list display tweaks.
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.