herdr: chạy nhiều AI coding agent trong một cửa sổ terminal — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về herdrdev/herdr — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: herdr: quản lý nhiều AI coding agent trong một terminal — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
herdr là một công cụ dòng lệnh viết bằng Rust, đóng vai "môi trường chạy" cho các AI coding agent như Claude Code hay Codex. Nó giữ các terminal chạy nền, đánh dấu từng ô là đang làm, bị kẹt hay rảnh, và cho bạn thoát ra rồi vào lại sau. Cài chỉ cần một dòng lệnh, chạy tiếp bằng lệnh herdr.
herdr là một chương trình chạy trong terminal, đóng vai "nơi sống" của các AI coding agent như Claude Code, Codex, Cursor, opencode, grok. Nó không thay thế các agent đó. Nó giữ các terminal của chúng chạy ở nền, chia thành nhiều ô, và cho bạn biết ô nào đang làm việc, ô nào đang chờ bạn trả lời.
Nếu bạn từng mở năm cửa sổ terminal cho năm agent rồi quên mất cái nào đang kẹt, hoặc mất kết nối SSH làm mất cả buổi làm việc, thì herdr sinh ra cho chuyện đó. Người nên dùng là lập trình viên (kể cả người mới) hay chạy nhiều agent cùng lúc, hoặc làm việc trên máy ở xa.
Điểm đáng giá nhất: bạn đóng cửa sổ hoặc rớt mạng mà công việc vẫn chạy tiếp ở nền, lúc nào cũng gõ herdr để vào lại. Repo hiện có khoảng 50.714 sao và 4.095 fork, giấy phép Apache-2.0, và vẫn được cập nhật trong 3 tháng gần đây.
herdrdev/herdr
herdr là chương trình terminal viết bằng Rust, giữ nhiều AI coding agent chạy nền, báo agent nào đang làm, bị kẹt hay rảnh, và cho bạn thoát ra rồi vào lại.
I.herdr làm được gì
Dưới đây là các tính năng chính, theo đúng những gì README mô tả.
A.Tách ra mà việc vẫn chạy
Khi bạn đóng client hoặc mất kết nối SSH, herdr giữ các terminal chạy trong một server nền. Bạn không phải bắt đầu lại từ đầu. Nếu server hoặc máy khởi động lại, herdr khôi phục bố cục đã lưu và có thể nối lại phiên của các agent được hỗ trợ. Lưu ý: tiến trình gốc thì không sống sót qua lần khởi động lại.
B.Nhiều máy, một cửa sổ
Bạn gom việc trên máy mình và các máy SSH đã lưu vào cùng một chỗ. Danh sách agent được gộp chung, và mỗi máy kết nối lại độc lập với nhau. Hợp với người có một máy ở nhà, một máy chủ ở xa.
C.Không phải đi tìm ô bị kẹt
Mỗi ô (pane) được đánh dấu một trong ba trạng thái: đang làm (working), bị chặn (blocked), hoặc rảnh (idle). Khi agent dừng lại để chờ bạn trả lời, herdr báo cho bạn biết. Bạn đỡ phải bấm qua từng cửa sổ để kiểm tra.
D.Agent tự điều khiển herdr
Các agent có thể điều khiển herdr qua dòng lệnh và socket API. Chúng có thể mở ô mới, nhắn cho agent khác, và chờ đến khi agent kia thật sự bị chặn. README có nhắc một "agent skill" cho việc này, chi tiết nằm ở trang tài liệu riêng.
E.Chạy đúng những gì bạn đang chạy
herdr không bọc hay thay thế Claude Code, Codex, Cursor, opencode, grok và các agent khác. Nó chỉ sở hữu terminal của chúng. Danh sách agent được hỗ trợ có ở trang tài liệu "supported agents".
F.Bàn phím và chuột đều dùng tốt
Bạn có thể dùng phím tắt kiểu tmux (có phím prefix) hoặc click, kéo, chia ô bằng chuột. Thích kiểu nào dùng kiểu đó, tuỳ lúc.
G.Plugin và một file chạy duy nhất
Có chợ plugin để mở rộng ô và quy trình làm việc. herdr là một file chạy viết bằng Rust, không dùng Electron, và chạy trong terminal bạn đang dùng sẵn.
II.Cần chuẩn bị gì
Tư liệu README ghi rất ít yêu cầu, nên mình chỉ nêu những gì có:
- Một terminal bạn đang dùng. herdr chạy trong terminal đó.
- Hệ điều hành: README có lệnh cài cho shell kiểu Unix (macOS/Linux), cho Homebrew, cho mise, và riêng cho Windows bằng PowerShell. Với Windows có trang riêng tên "windows-beta", kể cả cho máy có phần mềm bảo vệ endpoint.
- Một hoặc vài AI coding agent bạn muốn chạy bên trong, ví dụ Claude Code hay Codex. Các agent này có tài khoản hoặc key riêng của chúng, herdr không quản lý chuyện đó.
- Nếu muốn làm việc nhiều máy: các máy SSH bạn đã có.
- Nếu muốn tự build từ mã nguồn: cần có Rust và công cụ
cargo. Repo có filerust-toolchain.tomlvàjustfile.
README không nói herdr cần API key hay GPU. Phần cứng cụ thể cũng chưa có thông tin.
III.Cài đặt từng bước
- Chọn cách càiDùng lệnh một dòng, Homebrew, mise hoặc PowerShell tuỳ máy
- Chạy lệnh càiDán lệnh vào terminal và đợi xong
- Mở herdrGõ herdr ở thư mục bạn đang làm việc
- Chạy agentMở agent của bạn trong ô, chia thêm ô nếu cần
- Thoát và vào lạiDùng ctrl+b q để tách ra, gõ herdr để nối lại
A.Bước 1: Chọn cách cài phù hợp
README đưa ra vài đường cài. Chọn một:
- macOS hoặc Linux: lệnh một dòng bằng
curl. - Có Homebrew:
brew install herdr. - Có mise:
mise use -g herdr. - Windows: lệnh PowerShell.
- Muốn tải thẳng file chạy: vào trang Releases của repo.
B.Bước 2: Chạy lệnh cài
Trên macOS/Linux, mở terminal và dán:
curl -fsSL https://herdr.dev/install.sh | shLệnh này tải script cài đặt từ herdr.dev rồi đưa cho sh chạy. Nếu bạn muốn biết script làm gì trước khi chạy, hãy mở địa chỉ đó trong trình duyệt để đọc.
Dùng Homebrew:
brew install herdrDùng mise:
mise use -g herdrTrên Windows, mở PowerShell và dán:
powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"Lệnh này tải script cài rồi chạy ngay, và tạm bỏ qua chính sách chạy script của PowerShell cho riêng lệnh này. Nếu máy công ty của bạn có phần mềm bảo vệ endpoint, hãy xem trang tài liệu "windows-beta" của herdr trước khi chạy.
Các lệnh dạng "tải về rồi chạy ngay" sẽ chạy script từ internet với quyền của bạn. Trên máy công ty hoặc máy chứa dữ liệu quan trọng, hãy đọc script trước hoặc hỏi bộ phận IT.
C.Bước 3: Mở herdr nơi bạn làm việc
README dặn: khởi động nó ở nơi công việc diễn ra. Nghĩa là bạn cd vào thư mục dự án của mình rồi gõ:
herdrNgười mới hay vấp ở chỗ gõ lệnh này ngay thư mục chủ (home) rồi không hiểu vì sao agent không thấy code. Hãy cd vào đúng thư mục dự án trước.
D.Bước 4: Chạy agent, chia ô, rồi đi làm việc khác
README mô tả quy trình ngắn: chạy các agent của bạn, chia ô, rồi cứ đi chỗ khác. Phím ctrl+b q để tách ra (detach), còn gõ lại herdr để nối lại. Danh sách phím tắt đầy đủ nằm ở trang "keyboard" trong tài liệu. README không liệt kê thêm phím nào khác nên mình không đoán.
E.Bước 5 (tuỳ chọn): Tự build từ mã nguồn
Nếu bạn là lập trình viên và muốn tự build:
git clone https://github.com/herdrdev/herdr
cd herdr
cargo build --releaseBa lệnh này tải mã nguồn, vào thư mục, rồi build bản release bằng cargo. Bước này cần máy đã có Rust. Người chỉ muốn dùng thì không cần làm bước này.
IV.Kiểm tra đã chạy được chưa
Cách kiểm tra đơn giản nhất theo README:
- Mở terminal mới, gõ
herdr. Nếu giao diện herdr hiện ra, cài đặt đã thành công. - Thử tách ra bằng
ctrl+b q, rồi gõ lạiherdr. Nếu bạn quay về đúng phiên cũ thì phần giữ việc chạy nền đã hoạt động. - Mở một agent trong một ô, bạn sẽ thấy ô được đánh dấu đang làm, bị chặn hoặc rảnh.
README không nêu thông báo hay số phiên bản cụ thể để đối chiếu, nên mình chỉ dựa vào những dấu hiệu trên. Nếu lệnh herdr báo không tìm thấy, xem phần lỗi bên dưới.
V.Dùng vào việc thật
A.Lập trình viên chạy ba agent song song
Bối cảnh: bạn đang sửa một ứng dụng, muốn một agent viết test, một agent sửa lỗi, một agent đọc code cũ.
Cách làm: cd vào thư mục dự án, gõ herdr, chia thành ba ô và chạy mỗi agent trong một ô. Bạn làm việc khác, thỉnh thoảng nhìn trạng thái của từng ô.
Kết quả: ô nào dừng để hỏi bạn sẽ được đánh dấu bị chặn. Bạn không phải bấm qua từng cửa sổ để dò xem cái nào đang đứng.
Không cần canh từng cửa sổ: agent nào đang chờ bạn, herdr nói cho bạn biết.
Ông T
B.Rời máy giữa chừng mà không mất việc
Bối cảnh: bạn cho agent chạy một việc dài, sắp phải ra khỏi nhà hoặc đóng laptop.
Cách làm: bấm ctrl+b q để tách ra. Khi quay lại, gõ herdr để nối vào đúng phiên cũ.
Kết quả: các terminal vẫn chạy ở server nền trong lúc bạn đi vắng. Nhớ rằng nếu cả máy hoặc server khởi động lại, herdr chỉ khôi phục bố cục và có thể nối lại phiên của các agent được hỗ trợ. Tiến trình gốc thì mất.
C.Làm việc qua SSH trên máy chủ ở xa
Bối cảnh: bạn có một máy chủ mạnh hơn laptop để chạy agent, và kết nối SSH hay chập chờn.
Cách làm: lưu máy SSH vào herdr theo hướng dẫn ở trang "connecting machines" trong tài liệu, README không ghi lệnh cụ thể. Sau đó bạn xem việc ở máy mình và máy xa trong cùng một cửa sổ.
Kết quả: danh sách agent được gộp chung, và mỗi máy kết nối lại độc lập. Một máy rớt mạng không kéo theo các máy còn lại.
D.Cho agent này điều phối agent khác
Bối cảnh: bạn muốn một agent "chủ" giao việc cho agent phụ rồi chờ kết quả.
Cách làm: README cho biết agent có thể điều khiển herdr qua dòng lệnh và socket API, mở ô mới, nhắn cho agent khác, và chờ đến khi agent kia thật sự bị chặn. Cách cài và dùng agent skill nằm ở trang tài liệu "agent skill"; repo cũng có thư mục skills/.
Kết quả: agent chủ có thể giao việc cho agent phụ và đợi đúng lúc agent phụ cần câu trả lời, thay vì bạn làm người chuyền tin ở giữa. Phần này hợp với người đã quen chạy agent, người mới nên làm quen ba tình huống trên trước.
VI.Lỗi hay gặp và cách xử lý
README không có mục xử lý lỗi, nên các mục dưới đây là những lỗi rất dễ gặp với loại công cụ này. Cách khắc phục chỉ dùng thao tác an toàn.
A.Gõ herdr báo không tìm thấy lệnh
Nguyên nhân thường là terminal chưa nhận đường dẫn mới sau khi cài. Hãy đóng terminal rồi mở lại và thử herdr lần nữa. Nếu vẫn lỗi, chạy lại cách cài khác (ví dụ Homebrew) hoặc tải file chạy ở trang Releases.
B.Windows chặn lệnh cài hoặc phần mềm bảo mật chặn
Máy công ty hay có chính sách chặn script. README có trang riêng cho Windows có phần mềm bảo vệ endpoint, hãy đọc trang đó. Đừng tắt phần mềm bảo mật của công ty nếu chưa được phép.
C.Tách ra rồi nhưng không thấy phiên cũ
Hãy chắc bạn gõ herdr trên đúng máy đã chạy phiên đó. Nếu máy hoặc server đã khởi động lại, tiến trình gốc không còn. herdr chỉ khôi phục bố cục và có thể nối lại phiên của agent được hỗ trợ. Muốn biết agent của bạn có được hỗ trợ không, xem trang "supported agents".
D.Agent bị kẹt nhưng bạn không biết vì sao
Ô bị chặn nghĩa là agent đang chờ bạn trả lời. Hãy bấm vào ô đó, đọc câu hỏi và trả lời. Đừng tự động duyệt mọi yêu cầu cấp quyền của agent mà không đọc, nhất là khi nó định xoá file hoặc chạy lệnh lạ.
E.Build từ mã nguồn thất bại
Bạn cần có Rust đã cài. Repo có rust-toolchain.toml nên đúng phiên bản Rust sẽ được chọn theo file này. Nếu chỉ muốn dùng thì quay lại các cách cài ở Bước 1 cho đỡ rắc rối.
VII.Có nên dùng không
Điểm mạnh: herdr giải quyết đúng nỗi đau của người chạy nhiều agent, là mất dấu và mất phiên. Nó không ép bạn bỏ công cụ đang dùng. Chỉ một file chạy, không cần Electron, có cả phím tắt lẫn chuột, và giấy phép Apache-2.0 khá thoải mái.
Giới hạn: nó là công cụ terminal, nên người chưa quen dòng lệnh sẽ cần thời gian làm quen. Khi máy hoặc server khởi động lại, tiến trình gốc không sống sót. README cũng chưa nói rõ về yêu cầu phần cứng, và phần Windows đang ghi là beta.
Nên chọn herdr nếu bạn chạy từ hai agent trở lên, hay làm việc qua SSH. Nếu bạn chỉ dùng một agent trong một cửa sổ và không lo mất kết nối, terminal bình thường là đủ. Nếu bạn muốn một giao diện đồ hoạ cửa sổ thay vì terminal, herdr không phải loại đó.
Câu hỏi thường gặp
herdr có miễn phí không?
Repo dùng giấy phép Apache-2.0, một giấy phép mã nguồn mở. README không nhắc đến phí dùng herdr. Tuy nhiên các agent bạn chạy bên trong (như Claude Code hay Codex) có điều kiện sử dụng và chi phí riêng của chúng.
herdr có thay thế Claude Code hay Codex không?
Không. README nói rõ herdr không bọc hay thay thế các agent. Nó chỉ sở hữu terminal của chúng, nên bạn vẫn chạy các agent như Claude Code, Codex, Cursor, opencode, grok như bình thường.
herdr chạy được trên Windows không?
Có lệnh cài riêng cho Windows bằng PowerShell, và có một trang tài liệu "windows-beta" cho cả máy có phần mềm bảo vệ endpoint. Chữ beta cho thấy phần này còn mới. Chi tiết hơn README chưa có.
Cần GPU hay máy cấu hình cao không?
README không nêu yêu cầu phần cứng. herdr là một file chạy viết bằng Rust, không dùng Electron, chạy trong terminal bạn đang có. Còn agent bên trong có thể cần tài nguyên riêng.
Nếu tôi đóng terminal hoặc mất mạng thì agent có dừng không?
README nói herdr giữ terminal chạy ở server nền khi bạn đóng client hoặc mất kết nối SSH. Bạn nối lại bằng lệnh herdr. Nếu server hoặc máy khởi động lại, herdr khôi phục bố cục và có thể nối lại phiên agent được hỗ trợ, nhưng tiến trình gốc thì không còn.
herdr khác gì tmux?
README có nhắc herdr dùng phím prefix kiểu tmux và cũng hỗ trợ chuột. Điểm khác là nó đánh dấu từng ô là đang làm, bị chặn hay rảnh, và cho agent điều khiển qua CLI và socket API. README không so sánh trực tiếp với tmux ngoài những điểm này.
Dữ liệu của tôi có an toàn không?
README không có phần nói về quyền riêng tư hay dữ liệu. Chưa có thông tin chính thức ở đây. Hãy xem tài liệu ở herdr.dev và đọc script cài đặt trước khi chạy trên máy quan trọng.


