Oleksandr Kuzmenko, РедакторОпубліковано 6 хв читанняЗа участі AI · перевірено редактором
TL;DR
- Worktrunk спрощує синтаксис git worktree, дозволяючи звертатися до каталогів за назвами гілок.
- Прапорець `-x` дозволяє створювати робочий простір і запускати в ньому Claude Code або Codex одним рядком.
- Підтримка copy-on-write усуває дублювання важких папок `node_modules` і `target` на APFS, btrfs та XFS.
Ключові факти
- Підтримувані CoW файлові системи
- APFS, btrfs, XFS
- Основні команди
- wt switch, wt list, wt merge, wt remove
- Підтримувані менеджери пакетів
- Homebrew, Cargo, Pacman, Winget (git-wt), Conda, Pixi
Проблема паралельної роботи з кількома агентами
Під час запуску кількох фонових агентів Claude Code або Codex розробники часто делегують їм одночасне виконання різних фіч. Проте використання стандартних команд Git worktree вимагає громіздкого синтаксису (git worktree add -b feat ../repo.feat && cd ../repo.feat), ручного очищення гілок і тривалого встановлення залежностей у кожну нову папку.
Worktrunk вирішує цю проблему, зводячи керування робочими деревами до простих операцій через утиліту wt.
Запуск агентів однією командою та хуки
Базовою командою для ініціалізації середовища є wt switch. Завдяки прапорцю виконання -x розробник може створити гілку, worktree та запустити агента однією командою:
wt switch -x claude -c feature-auth -- 'Add user authentication'
wt switch -x claude -c feature-bugfix -- 'Fix the pagination bug'Параметри після розділювача -- передаються безпосередньо у бінарник агента. Worktrunk підтримує хуки життєвого циклу для автоматичного встановлення залежностей (npm install, cargo build) та призначає унікальні порти локальним dev-серверам за допомогою фільтра hash_port.
Спільний кеш збірок через Copy-on-Write
Створення 10 окремих каталогів із важкими артефактами збірки швидко заповнює SSD. Worktrunk використовує системний механізм copy-on-write на APFS (macOS), btrfs та XFS (Linux). Десять різних worktree отримують доступ до node_modules/ або target/ без копіювання файлів та повторної компіляції.
Після завершення роботи команда wt merge автоматично виконує squash, rebase, мерджить зміни в main і фоново видаляє каталог worktree.
Спробуй за 2 хвилини
brew install worktrunk && wt config shell install
wt switch -x claude -c feature-auth -- 'Add user authentication'Коли використовувати
- Застосовуйте, коли запускаєте кількох автономних агентів паралельно над різними фічами в одному репозиторії.
- Використовуйте для швидкого перемикання між рев'ю PR і поточною гілкою без скидання локального стану.
Коли НЕ варто
- Не використовуйте на файлових системах без CoW (наприклад, ext4 або FAT32), якщо критично важливий швидкий шеринг кешів.
- Не застосовуйте, якщо в монорепозиторії вже налаштовано спеціалізовані інструменти sparse-checkout, що конфліктують із worktree.
Що зробити сьогодні
- Встановіть Worktrunk командою `brew install worktrunk` або `cargo install worktrunk` та виконайте `wt config shell install`.
- Налаштуйте шаблони шляхів у конфігурації репозиторію для автоматичного іменування каталогів worktree.
- Спробуйте запустити два паралельних завдання Claude Code за допомогою `wt switch -x claude -c <гілка> -- '<промпт>'`.
Назви кроків узяті з блоку «Що зробити сьогодні».
Назви кроків узяті з блоку «Що зробити сьогодні». Встановіть Worktrunk командою `brew install worktrunk` або `cargo install worktrunk` та виконайте `wt config shell install`.. Налаштуйте шаблони шляхів у конфігурації репозиторію для автоматичного іменування каталогів worktree.. Спробуйте запустити два паралельних завдання Claude Code за допомогою `wt switch -x claude -c <гілка> -- '<промпт>'`.
- Встановіть Worktrunk командою `brew install worktrunk` або `cargo install worktrunk` та виконайте `wt config shell install`.
- Налаштуйте шаблони шляхів у конфігурації репозиторію для автоматичного іменування каталогів worktree.
- Спробуйте запустити два паралельних завдання Claude Code за допомогою `wt switch -x claude -c <гілка> -- '<промпт>'`.