Worktrunk: quản lý git worktree cho quy trình AI agent
/worktrunk
Nên cài Worktrunk ngay khi bạn chạy một AI agent song song với công việc khác. Lệnh git worktree thường đòi gõ tên nhánh ba lần chỉ để tạo một worktree; Worktrunk gói những thao tác phổ biến thành một lệnh. Điểm cần lưu ý: tích hợp shell gần như bắt buộc để có trải nghiệm đầy đủ, và chia sẻ cache build theo cơ chế copy-on-write chỉ hoạt động trên APFS, btrfs và XFS — ext4 thì không được.
Worktrunk là gì
Worktrunk là CLI viết bằng Rust, gói các thao tác git worktree thành lệnh thân thiện hơn. Nó tính đường dẫn worktree từ tên nhánh theo template có thể tùy chỉnh, hiển thị danh sách với thông tin phong phú về số commit ahead/behind và nội dung commit gần nhất, đồng thời tích hợp với shell để chuyển worktree cũng tự động chuyển thư mục hiện tại. README mô tả công cụ này được thiết kế cho quy trình AI agent chạy song song — mỗi Claude Code hay Codex instance hoạt động trong thư mục riêng biệt, không xung đột nhau.
Các lệnh cốt lõi và tính năng
- ✓`wt switch` tạo hoặc chuyển vào worktree theo tên nhánh; đường dẫn được tính tự động
- ✓`wt list` hiển thị mọi worktree kèm trạng thái, thay đổi đã staged, số commit ahead/behind và nội dung commit
- ✓`wt remove` xóa worktree và tùy chọn xóa luôn nhánh đi kèm
- ✓`wt merge` gộp, rebase vào nhánh đích rồi dọn dẹp worktree trong một lệnh
- ✓`wt step` tự động hóa vòng đời commit-push với thông điệp do LLM tạo
- ✓Hooks chạy lệnh tùy chỉnh khi tạo worktree, trước/sau merge, và các sự kiện vòng đời khác
- ✓Cache build dùng chung theo cơ chế copy-on-write giúp nhiều worktree chia sẻ target/ và node_modules/ mà không phải build lại
- ✓Trình chọn tương tác kèm CI status streaming và preview diff/PR để duyệt worktree trực quan
Khi nào nên dùng Worktrunk
- •Chạy nhiều AI agent song song, mỗi agent trong worktree riêng, tránh agents ghi đè thay đổi của nhau
- •Quản lý nhiều feature branch cùng lúc mà không cần checkout qua lại
- •Chia sẻ artifact đã build qua các worktree trên APFS, btrfs hoặc XFS để bỏ qua bước biên dịch lại
- •Tự động thiết lập môi trường phát triển bằng hooks — cài dependency hoặc khởi động dev server khi tạo worktree
- •Thực hiện chu trình commit-merge-dọn dẹp hoàn chỉnh trên máy local mà không rời terminal
- •Review PR nhanh bằng cách nhảy thẳng đến nhánh của PR với `wt switch pr:123`
Cài đặt Worktrunk
Trên macOS và Linux, Homebrew là cách nhanh nhất: `brew install worktrunk && wt config shell install`. Windows chạy `winget install max-sixty.worktrunk`, cài dưới tên `git-wt` để tránh xung đột với alias `wt` của Windows Terminal. Muốn biên dịch từ mã nguồn thì `cargo install worktrunk`. Arch Linux có trong pacman, còn conda-forge phân phối qua Conda và Pixi. Sau khi cài bằng bất kỳ cách nào, chạy `wt config shell install` một lần để kích hoạt tích hợp shell.
Bắt đầu với wt switch và wt list
Tạo worktree mới cho feature branch và chuyển vào nó bằng một lệnh: `wt switch --create feature-auth`. Lệnh này tạo branch, tạo thư mục worktree và đưa bạn vào trong thư mục đó. Chạy `wt list` để xem mọi worktree cùng trạng thái, thay đổi đã staged và ngữ cảnh commit. Xong việc thì `wt remove` dọn dẹp worktree và branch. Để chạy Claude Code trong worktree mới: `wt switch -x claude -c feature-b -- 'Fix pagination'`. Cờ `-x` chạy lệnh sau khi chuyển xong; mọi thứ sau `--` được chuyển tiếp.
Những gì Worktrunk thêm vào so với git thường
- ✓Một lệnh thay thế ba đến bốn thao tác git thông thường để tạo worktree và vào thư mục
- ✓Tên nhánh là định danh chính, nên quản lý đường dẫn trở nên thừa thãi với các thao tác thường dùng
- ✓Tích hợp shell tự động chuyển thư mục hiện tại khi chuyển worktree
- ✓Trình chọn tương tác hiển thị CI status và tóm tắt PR ngay trong terminal
- ✓Chia sẻ cache build giữa các worktree giúp tránh biên dịch lại dependency trên nhiều worktree
- ✓Hỗ trợ chạy trực tiếp Claude Code và Codex khiến quy trình AI agent được thiết kế sẵn, không phải ghép thêm
Hạn chế và các trường hợp đặc biệt
- △Tích hợp shell (`wt config shell install`) gần như bắt buộc để có trải nghiệm đầy đủ — thêm một bước setup trên mỗi máy
- △Chia sẻ cache build chỉ hoạt động trên APFS, btrfs và XFS; ext4 thì không có tính năng này
- △Windows phải tắt alias `wt` của Windows Terminal hoặc dùng tên lệnh `git-wt`
- △Repository không khai báo license trong metadata — có thể là vấn đề với một số bên review tuân thủ
Các công cụ git worktree khác
Câu hỏi thường gặp
Trên macOS và Linux, Homebrew là cách nhanh nhất: `brew install worktrunk && wt config shell install`. Windows chạy `winget install max-sixty.worktrunk`, cài dưới tên `git-wt` để tránh xung đột với Windows Terminal's `wt` alias. Muốn biên dịch từ mã nguồn thì `cargo install worktrunk`. Arch Linux có trong pacman, còn conda-forge phân phối qua Conda và Pixi.
Có. Worktrunk được thiết kế cho những công cụ này. Dùng `-x claude` với `wt switch` để chạy Claude Code sau khi tạo hoặc vào worktree, các tham số sau `--` được chuyển tiếp đến agent. Codex được hỗ trợ tương tự. Mỗi agent nhận thư mục làm việc riêng biệt nên chúng không ghi đè thay đổi của nhau.
Lệnh này sửa cấu hình shell để Worktrunk có thể chuyển thư mục hiện tại khi chuyển worktree. Không có nó, `wt switch` vào worktree nhưng terminal vẫn ở thư mục cũ. Tích hợp hoạt động với bash, zsh, fish, nushell và pwsh. Chạy một lần trên mỗi máy.
Có. Trên các filesystem được hỗ trợ, Worktrunk cho phép nhiều worktree chia sẻ target/, node_modules/ và các thư mục build khác mà không cần sao chép hay biên dịch lại. Tính năng này dùng cơ chế copy-on-write của filesystem nên thay đổi trong một worktree vẫn được cô lập. README gọi đây là lợi ích cụ thể cho các team chạy nhiều worktree.
APFS (mặc định macOS), btrfs (phổ biến trên Linux) và XFS hỗ trợ tính năng copy-on-write mà Worktrunk dùng. ext4 — mặc định trên hầu hết bản phân phối Linux — thì không. Nếu chia sẻ cache build không hoạt động, kiểm tra filesystem bạn đang dùng.
Hooks là các lệnh tùy chỉnh chạy vào những thời điểm nhất định: create, pre-merge, post-merge, và các sự kiện khác. Có thể dùng để cài dependency khi worktree được tạo, khởi động dev server, hoặc chạy test sau merge. Hooks được cấu hình trong file config của Worktrunk và hỗ trợ biến theo nhánh để templatize.
Ai nên thử — và ai nên bỏ qua
Worktrunk là công cụ không thể thiếu nếu bạn đang chạy AI coding agent song song. Ngay cả khi chưa dùng agent, nếu quản lý nhiều feature branch tích cực, những cải tiện về trải nghiệm vẫn xứng đáng để cài. Những ai làm việc trên một nhánh hoặc hiếm khi phải chuyển đổi ngữ cảnh thì nên bỏ qua; lợi ích chỉ thực sự đến khi số worktree từ hai trở lên.
Repo liên quan
Muốn nghe thêm một ý kiến về worktrunk?
Hỏi một AI đọc được trang này — một cú bấm là có ngay nhận định về worktrunk.