Worktrunk là gì: quản lý git worktree cho AI agent chạy song song

Thử hình dung thế này. Anh chị mở ba cửa sổ Claude Code trên cùng một dự án: một cái sửa lỗi đăng nhập, một cái viết trang báo giá, một cái dọn lại phần thanh toán. Mười phút sau cả ba cùng sửa một file cấu hình. Cái này ghi đè cái kia, và không ai biết dòng nào của ai.

Giống ba đầu bếp cùng xào trên một cái thớt. Cách chữa quen thuộc là cho mỗi người một bàn bếp riêng. Git có sẵn tính năng này, tên là worktree, nhưng gõ lệnh khá cực. Worktrunk là gì? Worktrunk là công cụ dòng lệnh mã nguồn mở của max-sixty, dùng để tạo, chuyển, dọn các git worktree dễ như đổi nhánh, thiết kế cho người chạy nhiều AI agent song song.

Đọc nhanh trong 30 giây

• Worktrunk là CLI viết bằng Rust, lệnh chính là wt. Giấy phép ghi trong README: MIT hoặc Apache-2.0.
• Mỗi nhánh có một thư mục riêng, nên nhiều agent sửa code cùng lúc không đạp lên nhau. Ba lệnh cốt lõi: wt switch, wt list, wt remove.
• Cài bằng brew install worktrunk, hoặc winget install max-sixty.worktrunk trên Windows (lệnh khi đó là git-wt).
• Hợp với người đã chạy từ hai agent lập trình trở lên và quen terminal.
• Đánh giá nhanh: được quan tâm nhiều, bảo trì sát; nhưng mới ở bản 0.x và phần lớn commit đến từ một người cộng với một con bot.

Worktrunk là gì, dùng vào việc gì?

Worktrunk bọc quanh git worktree để mỗi nhánh có một thư mục làm việc riêng mà anh chị không phải gõ lại tên nhánh ba lần. README mô tả rõ nỗi đau: chỉ để mở một worktree, git thuần đã bắt gõ git worktree add -b feat ../repo.feat rồi cd ../repo.feat.

Hình dung một tòa nhà văn phòng cho thuê: kho hồ sơ chung ở tầng hầm (lịch sử git), mỗi nhánh là một phòng riêng có khóa riêng. Worktrunk là bảng chỉ dẫn ở sảnh, gõ tên phòng là tới nơi, thuê phòng mới hay trả phòng cũng chỉ một lệnh.

Bảng so sánh lấy từ README của Worktrunk.

Phần giới thiệu trên GitHub có sẵn ảnh động chạy ba lệnh cốt lõi:

Ảnh động: tác giả max-sixty, repo worktrunk-assets, hiển thị trực tiếp từ GitHub.

Worktrunk khác gì git worktree thuần?

Worktrunk giữ nguyên cơ chế worktree của git và thêm lớp tiện ích bên trên: gọi worktree bằng tên nhánh, tự tính đường dẫn theo mẫu cấu hình, báo trạng thái từng nhánh. Theo README, anh chị có thêm những thứ sau:

Ví dụ trong README: wt switch -c -x claude feat vừa tạo nhánh, vừa tạo worktree, vừa mở Claude trong đó.

Cài Worktrunk trong 2 phút

Cài bằng trình quản lý gói rồi bật tích hợp shell, vì cần nó để lệnh đổi được thư mục hiện tại. Lệnh chép đúng từ README:

Minh họa dựng lại theo README.

1. Trên macOS hoặc Linux:

brew install worktrunk && wt config shell install

2. Cài bằng Cargo:

cargo install worktrunk && wt config shell install

3. Trên Windows, wt trùng tên với Windows Terminal nên Winget cài thêm bản gọi là git-wt:

winget install max-sixty.worktrunk
git-wt config shell install

4. Tạo worktree đầu tiên trong một repo git:

wt switch --create feature-auth
wt list

Mẹo

Muốn dùng đúng lệnh wt trên Windows, README hướng dẫn tắt bí danh "Terminal" ở mục App execution aliases trong Settings. Nếu ngại đụng cài đặt hệ thống, cứ gọi git-wt cho nhanh gọn.

Hook: để máy làm việc lặt vặt mỗi lần tạo worktree

Hook của Worktrunk là các lệnh shell tự chạy ở từng mốc vòng đời worktree. Theo tài liệu, tiền tố pre- chạy chặn (lỗi thì dừng cả thao tác), tiền tố post- chạy nền và ghi log.

Sơ đồ lấy từ tài liệu wt hook trên worktrunk.dev.

Ví dụ hay gặp: pre-start để cài thư viện cho worktree mới, post-start để bật dev server chạy nền, pre-merge để chạy test trước khi gộp. Cấu hình nằm trong .config/wt.toml của repo, hoặc file cấu hình người dùng.

Ví dụ dùng thực tế

Việc 1: ba agent, ba nhánh. Ở thư mục repo, anh chị mở ba cửa sổ terminal và gõ lần lượt:

wt switch -c -x claude fix-login
wt switch -c -x claude trang-bao-gia
wt switch -c -x claude don-thanh-toan

Mỗi cửa sổ có một Claude làm việc trong thư mục riêng. Quay lại xem tiến độ bằng wt list.

Việc 2: gộp thành quả. Khi nhánh fix-login xong, chạy wt merge main. README cho thấy lệnh này commit nốt thay đổi, rebase lên main, merge rồi gỡ worktree và nhánh phụ. Hoặc đi đường pull request: wt step commit, gh pr create, sau khi merge xong thì wt remove.

Nếu anh chị đang quan tâm chuyện agent nhớ việc qua các phiên, đọc thêm Claude-Mem là gì. Hai công cụ giải hai bài toán khác nhau: Claude-Mem giữ trí nhớ, Worktrunk giữ chỗ làm việc không đụng nhau.

Worktrunk có đáng tin không? Soi nhanh trên GitHub

Worktrunk có 12,4 nghìn sao và 5.533 commit từ ngày 17/10/2025, trong đó 2.093 sao đến trong một tuần theo GitHub Trending. Số sao giống lượng khách vào cửa hàng: cho biết nhiều người tò mò, chưa cho biết hàng bền hay không. Phải xem thêm hàng có người sửa mỗi ngày không.

Trang repo trên GitHub, chụp ngày 11/11/2026.

Số liệu tra bằng GitHub API và ảnh chụp ngày 11/11/2026.

Góc nhìn phản biện

Cảnh báo

• Hook là lệnh shell chạy trên máy anh chị. Tài liệu nói lệnh trong cấu hình dự án phải được duyệt ở lần chạy đầu và duyệt lại khi lệnh đổi. Đọc kỹ .config/wt.toml của repo lạ trước khi bấm đồng ý, và tránh thói quen thêm --yes cho mọi lệnh.
• Giấy phép chưa hiện rõ trên GitHub. README ghi MIT hoặc Apache-2.0, nhưng trang repo chỉ hiện chữ "License" không kèm tên. Dùng trong công ty thì mở file LICENSE ra đọc trước.
• Bản 0.x nghĩa là lệnh có thể đổi. Với script nội bộ gọi wt, nên ghi lại bản đang dùng, nâng bản xong thì chạy thử.
• Phụ thuộc vào rất ít người. Theo thống kê đóng góp, max-sixty có 4.132 commit và tài khoản worktrunk-bot có 836 commit. Nếu tác giả dừng, dự án khó có người nối.
• Cache dùng chung không phải hệ nào cũng có. README chỉ nêu APFS, btrfs và XFS; tài liệu không nói về NTFS của Windows.

Worktrunk giống chiếc xe đẩy hàng trong siêu thị: tiện khi mua nhiều món, thừa khi chỉ cầm một chai nước. Chạy một agent trên một nhánh thì git thường đã đủ.

Lưu ý

Worktrunk chỉ tách thư mục, không tách việc. Hai agent vẫn có thể sửa cùng một đoạn code ở hai nhánh rồi xung đột khi merge. Hãy giao việc theo từng khu vực code khác nhau.

Câu hỏi thường gặp

Worktrunk có miễn phí không?

Worktrunk là mã nguồn mở, README ghi giấy phép MIT hoặc Apache-2.0. Tài liệu không nói về gói trả phí. Chi phí phát sinh nếu có là của các agent như Claude Code mà anh chị chạy bên trong.

Dùng Worktrunk có bắt buộc dùng Claude Code không?

Không. README nêu Claude Code và Codex như ví dụ agent chạy song song, còn bản thân wt quản lý git worktree, dùng độc lập với agent.

Worktrunk chạy được trên Windows không?

Chạy được qua Winget. Vì wt trùng tên lệnh của Windows Terminal, bản Winget cài thêm lệnh git-wt để tránh trùng.

Worktrunk khác git worktree ở điểm nào?

Worktrunk không thay thế git worktree mà bọc ngoài nó. Anh chị gọi worktree bằng tên nhánh, có thêm trạng thái, hook và lệnh gộp một bước.

Nhận xét của chuyên gia

Khi đào tạo AI cho đội kỹ thuật, tôi thấy người mới chạy đa agent hay vấp một chỗ: sức máy còn thừa, nhưng thư mục làm việc thì chỉ có một. Họ chờ agent này xong mới dám mở agent kia. Worktrunk gỡ đúng nút thắt đó bằng cách đơn giản nhất: mỗi việc một thư mục.

Hợp với ai: lập trình viên, người làm dự án web đã quen Claude Code hoặc Codex; đội muốn chạy nhiều việc nhỏ cùng lúc trên một repo; người dạy AI cần minh họa chuyện "nhiều agent cùng làm" mà không loạn.

Chưa hợp với ai: người chưa dùng git hằng ngày; người chỉ chat AI trên web; đội cần công cụ đã ổn định ở bản 1.0.

Cách bắt đầu của tôi: thử trên một repo nhỏ, không quan trọng. Tạo hai worktree, cho hai agent làm hai việc tách biệt, rồi wt merge. Chạy ổn rồi mới thêm hook.

Một câu để nhớ: Worktrunk không làm agent thông minh hơn, nó chỉ cho mỗi agent một bàn làm việc riêng để khỏi giành thớt.

Nguồn: Worktrunk, README và tài liệu, 11/11/2026. Tài liệu: worktrunk.dev. Ngày tra nguồn: 11/11/2026.