diff --git a/README.md b/README.md index ecf66f1..d211831 100644 --- a/README.md +++ b/README.md @@ -43,6 +43,56 @@ Tài liệu này tổng hợp các công cụ, cấu hình và phương pháp gi ## 3. Các Plugin & MCP Khuyên Dùng +### [AgentHub](https://git.smartgift.io.vn/Smartgift-AI/AgentHub) — dashboard nội bộ theo dõi & điều khiển agent + +* **Lợi ích:** Thấy được agent đang làm gì theo thời gian thực — session, tool call, token, chi phí, cây subagent, transcript — thay vì đoán qua terminal. Chạy nhiều lane song song và biết lane nào đang ở bước nào. +* **Cách hoạt động:** Hook của Claude Code POST mọi tool call lên server Express + SQLite chạy local, UI React cập nhật qua WebSocket. Toàn bộ dữ liệu nằm trên máy bạn. +* **Chức năng chính:** + * **Lane** — mỗi thư mục làm việc là một lane, sống sót qua restart, đi qua pipeline stage và hiển thị tiến độ (stage khai báo bằng `agenthub stage`, còn stage suy luận từ tool stream chỉ hiện màu amber, không bao giờ là "done"). + * **Chạy Claude Code / Codex ngay trong trình duyệt** — terminal thật (tmux + PTY, xterm.js), tương tác đầy đủ, resume được, attach lại được từ terminal máy. + * **Analytics & chi phí** theo model, alert + webhook, import lịch sử session (kể cả từ máy khác qua SSH). + * **Trình xem cấu hình Claude Code + Codex** — plugin, skill, subagent, slash command, MCP, hook, memory… xem hết, sửa được các file dạng text. + * **CLI `agenthub`** cho toàn bộ bề mặt trên, cộng ship pipeline (`/agenthub:ship-full`, `/agenthub:ship-quick`). + +**Cài đặt** — không cần clone. Đã đăng ký marketplace `sg` ở [mục 4](#4-cac-skills-nen-cai) rồi thì chỉ một lệnh: + +```bash +claude plugin install agenthub@sg +``` + +Chưa dùng marketplace `sg` thì cài từ marketplace riêng của AgentHub: + +``` +/plugin marketplace add https://git.smartgift.io.vn/Smartgift-AI/AgentHub.git +/plugin install agenthub@agenthub +``` + +> [!IMPORTANT] +> **Chỉ chọn MỘT trong hai đường.** Cài dashboard từ cả `sg` lẫn marketplace riêng của AgentHub sẽ chạy **hai bộ hook ingestion song song** — mỗi event vào database hai lần, token và cost bị đếm đôi. + +Lần session-start kế tiếp sẽ tự cài hook, boot server, đưa CLI `agenthub` vào PATH (chạy nền). Sau đó dùng `/agenthub-doctor` để kiểm tra, `/agenthub-open` để build UI và lấy URL, `/agenthub-update` để cập nhật. + +**Yêu cầu trước khi cài:** + +| Cần | Vì sao | +|---|---| +| Node >= 22.5 | Bản cài qua plugin dùng `node:sqlite` (không có `better-sqlite3` native) | +| git | Mọi thao tác lane (worktree, đọc branch/status) | +| **tmux** | **Bắt buộc** nếu muốn chạy agent từ trình duyệt hoặc dùng `agenthub lanes shell` — dashboard gọi thẳng binary `tmux`, không có bản dự phòng | +| `gh` (tùy chọn) | Chỉ cần cho `agenthub lanes ci status` và các bước mở PR | + +```bash +sudo apt install git tmux # Ubuntu / Debian +brew install git tmux # macOS +tmux -V # xác nhận: tmux 3.x +``` + +Windows không có tmux native — chạy AgentHub trong WSL2 và cài tmux ở trong đó. Thiếu tmux thì dashboard vẫn chạy bình thường, chỉ riêng nút **Start Run** và `agenthub lanes shell` là lỗi. + +> Hướng dẫn đầy đủ: [README.vi.md](https://git.smartgift.io.vn/Smartgift-AI/AgentHub/src/branch/main/README.vi.md) · [INSTALL.md](https://git.smartgift.io.vn/Smartgift-AI/AgentHub/src/branch/main/INSTALL.md) · [docs/PLUGINS.md](https://git.smartgift.io.vn/Smartgift-AI/AgentHub/src/branch/main/docs/PLUGINS.md) + +### MCP + *Chưa cập nhật* ---