docs: nêu rõ tmux là yêu cầu của run console AgentHub

README chỉ nói Node >= 22.5, nên máy cài xong chỉ phát hiện thiếu tmux lúc
bấm Start Run và không có gì giải thích vì sao. Thêm bảng yêu cầu
(Node/git/tmux), lệnh cài theo OS, ghi chú Windows phải dùng WSL2, và cách
tự kiểm tra bằng /agenthub-doctor (dòng `tmux` báo WARN khi thiếu).
This commit is contained in:
2026-09-11 10:46:38 +07:00
parent 8336289d34
commit edefb18aca
+17 -2
View File
@@ -38,8 +38,23 @@ Xem: `claude plugin list`. Gỡ: `claude plugin uninstall sg-all@sg` (hoặc `sg
claude plugin install agenthub@sg
```
Cần Node **>= 22.5** trên máy cài (server dùng `node:sqlite`, không có
`better-sqlite3` native). Chi tiết bootstrap, các lệnh `/agenthub-doctor`
Yêu cầu trên máy cài:
| Cần | Vì sao |
|---|---|
| **Node >= 22.5** | Server dùng `node:sqlite`, bản cài qua plugin không có `better-sqlite3` native |
| **git** | Mọi thao tác lane (worktree, đọc branch/status) |
| **tmux** | Chỉ cần nếu muốn chạy Claude Code/Codex ngay trong 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. Thiếu nó thì phần theo dõi session vẫn chạy bình thường, chỉ nút **Start Run** là lỗi |
```bash
sudo apt install git tmux # Ubuntu / Debian
brew install git tmux # macOS
```
Windows không có tmux native — chạy AgentHub trong WSL2 và cài tmux ở trong đó.
Cài xong chạy `/agenthub-doctor` để kiểm tra: dòng `tmux` sẽ báo `WARN` nếu thiếu.
Chi tiết bootstrap, các lệnh `/agenthub-doctor`
`/agenthub-update` `/agenthub-open`, và cách gỡ sạch: xem
[docs/PLUGINS.md của AgentHub](https://git.smartgift.io.vn/Smartgift-AI/AgentHub/src/branch/main/docs/PLUGINS.md).