HERDR HANDBOOK · VI
Git Worktree + Herdr
Tách checkout theo task/agent để chạy parallel coding an toàn hơn và giảm conflict do cùng sửa một working tree.
1. Vì sao dùng Git Worktree với AI
Nhiều agents sửa cùng working directory dễ giẫm file và index. Worktree cho mỗi task một checkout riêng nhưng vẫn dùng chung repository object database.
2. Command worktree
# Tạo branch/worktree từ repo hiện tại
herdr worktree create --cwd ~/projects/my-app --branch feature/login
# Liệt kê
herdr worktree list --cwd ~/projects/my-app
# Mở branch đã có
herdr worktree open --cwd ~/projects/my-app --branch feature/login
# Remove workspace/worktree
herdr worktree remove --workspace <workspace-id>
# Khi dirty và bạn thực sự chấp nhận mất checkout
herdr worktree remove --workspace <workspace-id> --force
Branch không tự bị xóa
Remove worktree không đồng nghĩa xóa Git branch. Hãy
quản lý branch lifecycle riêng.
3. Cấu trúc multi-worktree
my-app main ├─ feature/frontend → Codex Frontend ├─
feature/backend → Codex Backend └─ review → Codex Reviewer
4. Quy tắc nên áp dụng
- Một agent thực thi lớn → một worktree/branch riêng.
- Không cho reviewer sửa chung branch với implementer trừ khi chủ động.
- Commit nhỏ, message rõ để merge/cherry-pick dễ.
-
Trước khi remove worktree, kiểm tra
git status.
5. Lab
- Tạo repo demo có commit đầu tiên.
- Tạo worktree
feature/a. - Mở worktree đó thành Herdr workspace.
- Chạy một Codex trong branch A và một Codex trong main.
- Quan sát hai working directory độc lập.