Git Worktrees

Worktrees giải quyết một trong những vấn đề khó chịu nhất trong phát triển hàng ngày: cần chuyển branch khi đang làm dở thứ gì đó. Với worktrees, bạn không chuyển — bạn mở branch khác trong thư mục thứ hai và làm việc trên cả hai cùng lúc.

Git Worktree Là Gì?

Thông thường, một git repository có một working directory — thư mục nơi files của bạn sống. Tại bất kỳ thời điểm nào, chính xác một branch được checkout trong thư mục đó. Nếu muốn xem branch khác, bạn phải checkout nó, điều này thay thế files của bạn bằng phiên bản của branch đó. Nếu chưa commit công việc hiện tại, bạn phải stash trước, điều này phiền phức và dễ lỗi.

Một worktree là working directory thứ hai (hoặc ba, hoặc bốn) liên kết với cùng git repository. Mỗi worktree có branch riêng được checkout, trạng thái file riêng, và lịch sử riêng. Tất cả chia sẻ cùng thư mục .git và lịch sử commit — chúng chỉ là các cửa sổ khác nhau vào cùng repo.

Ví dụ cụ thể: AI agent của bạn đang xây dựng dở feature mới trên feature/payments. Đồng nghiệp yêu cầu bạn review PR của họ trên fix/login-bug. Thay vì stash công việc feature, bạn tạo worktree cho fix/login-bug trong thư mục riêng. Bạn review PR ở đó trong khi feature branch vẫn nguyên vẹn trong thư mục gốc.

Tạo Worktree

1. Mở panel Git — nhấn Cmd+G
2. Click tab Worktrees ở đầu panel
3. Click + Add Worktree
4. Chọn branch — branch hiện có từ danh sách hoặc gõ tên branch mới để tạo
5. Chọn vị trí thư mục cho worktree mới (mặc định, 1DevTool gợi ý thư mục cạnh thư mục project hiện tại)
6. Click Create — 1DevTool chạy git worktree add và mở thư mục worktree mới làm workspace hoạt động

Worktree mới giờ được liệt kê trong tab Worktrees cạnh worktree chính của bạn.

Terminal Worktree

Khi 1DevTool tạo worktree, nó cũng mở terminal mới scoped đến thư mục của worktree đó. Tên branch hiện ra trong tiêu đề terminal để bạn luôn biết mình đang làm việc trên branch nào.

AI agent trong terminal đó hoạt động trong thư mục worktree — nó có thể đọc và ghi files, chạy commands, và tạo changes trên branch đó mà không biết đến hoặc can thiệp vào các branch khác của bạn.

Bạn có thể chạy agents trên nhiều worktrees cùng lúc. Một agent làm việc trên payments feature trong khi agent khác fix bug trên branch khác. Cả hai agents có terminal riêng, file context riêng, và branch riêng — chúng không thể xung đột với nhau.

Xóa Worktree

Khi bạn xong việc với worktree — PR đã merge, branch đã xóa — bạn có thể xóa nó sạch sẽ:

1. Mở panel Git và đi đến tab Worktrees
2. Tìm worktree bạn muốn xóa
3. Click icon thùng rác cạnh nó
4. Xác nhận xóa

Điều này xóa thư mục worktree và deregister nó khỏi git (tương đương git worktree remove). Bản thân branch không bị xóa — chỉ working directory. Bạn có thể tạo lại worktree sau nếu cần.

Mẹo: Dùng worktrees để chạy AI agent trên feature branch trong khi giữ main ổn định. Agent không thể vô tình phá branch main của bạn.

Worktrees là một trong những tính năng ít được dùng nhất của git. Trong bối cảnh phát triển hỗ trợ AI — nơi agent có thể tạo hàng chục thay đổi file trong vài phút — khả năng cô lập công việc của mỗi agent vào branch và thư mục riêng là một lớp bảo vệ đáng kể.