From edefb18aca9374c1fd752185c14417b96c99d694 Mon Sep 17 00:00:00 2001 From: nntrivi2001 Date: Fri, 11 Sep 2026 10:46:38 +0700 Subject: [PATCH] =?UTF-8?q?docs:=20n=C3=AAu=20r=C3=B5=20tmux=20l=C3=A0=20y?= =?UTF-8?q?=C3=AAu=20c=E1=BA=A7u=20c=E1=BB=A7a=20run=20console=20AgentHub?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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). --- README.md | 19 +++++++++++++++++-- 1 file changed, 17 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index b3f8060..df7f6e2 100644 --- a/README.md +++ b/README.md @@ -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).