Git worktrees: основа для запуску декількох AI агентів без конфліктів

Ви запускаєте два агенти на одному репозиторії. Один редагує package.json, інший робить те ж саме. Через тридцять секунд ваш код у стані, який ніхто не може змерджити.

Це не помилка у ваших агентах. Проблема в тому, що вони всі працюють в одній папці.

Рішенням є інструмент, який Git має вже багато років, але майже ніхто не використовує: git worktree.

Проблема: 3 агенти, 1 репозиторій, неможливий мердж

Звичайний Git репозиторій: це одна папка з однією гілкою, яка перевіряється одночасно. Ви працюєте на main, перемикаєтеся між гілками, і вся папка змінюється.

Тепер додайте три автономні агенти в цю папку. Вони пишуть одночасно. Агент A створює файл, агент B запускає git checkout, щоб почати з чистого аркуша, і видаляє роботу A в процесі. Ви отримуєте наполовину написані файли, зіпсований індекс і конфлікти, які займають більше часу на розв'язання, ніж якби ви самі це закодували.

Паралелізм економить ваш час лише якщо агенти не заважають один одному.

Що таке git worktree

Worktree: це друга робоча папка, прикріплена до того ж репозиторію.

Та ж історія, той же віддалений репозиторій, але кожен worktree має свою власну гілку, перевірену та свої власні файли на диску. Ви можете мати п'ять поруч, кожен на різній гілці, без того, щоб вони заважали один одному.

Один .git, кілька робочих просторів. Ось і все.

Один worktree на агента, на практиці

Ось налаштування. З вашого репозиторію:

git worktree add ../project-auth -b feature/auth
git worktree add ../project-billing -b feature/billing
git worktree add ../project-export -b feature/export

Ви щойно створили три папки, кожна на своїй гілці. Ви запускаєте агента в кожній:

cd ../project-auth && claude
cd ../project-billing && codex

Кожен агент має свою папку, свою гілку, свої файли. Агент аутентифікації ніколи не побачить, що робить агент білінгу. Ніяких можливих зіткнень.

Коли функція готова, ви переглядаєте її гілку і змерджуєте. Потім ви очищуєте:

git worktree remove ../project-auth

Папка зникає, гілка залишається в вашій історії. Чисто.

3 пастки, які потрібно знати

Перша пастка: спільний центральний файл. Якщо дві функції повинні торкатися одного й того ж routes.ts або тієї ж схеми бази даних, worktrees вас не врятують, ви отримаєте конфлікт під час мерджу. Один агент торкається файлів, які всі ділять, інші чекають або обходять це.

Друга: гілки, які відстають. Поки ваші агенти працюють, main рухається далі. Через три дні ваші гілки відстають, і мердж стає болючим. Перебазуйтеся рано і часто, або тримайте сесії короткими.

Третя: забуте очищення. Кожен worktree: це реальна папка на вашому диску. Десять на день без очищення, і ваша батьківська папка стає нечитаємою. git worktree list показує, що залишилося, git worktree prune видаляє мертві.

Справжнє питання: хто стежить за п'ятьма папками?

Worktrees вирішують проблеми зіткнень файлів. Вони не вирішують вашого ментального навантаження.

У вас є п'ять папок, п'ять агентів, п'ять терміналів. Який з них чекає на ваш огляд? Який закінчив десять хвилин тому, поки ви дивилися в інший бік? Який з них зламався?

Ось де один worktree на агента досягає своєї межі, якщо ви залишаєтеся в терміналі. Ви вирішили технічний конфлікт, але збільшили кількість вікон для спостереження.

AgentsRoom розміщує кожного агента на плитці, з його статусом і кольором, незалежно від того, в якому worktree він працює. Агент, який чекає, стає червоним і пінгує вас. Прочитайте як запускати від 3 до 8 агентів паралельно, не втрачаючи сліду для повного методу поверх worktrees.

Що взяти з собою

Один агент, один worktree, одна гілка. Це базове правило серйозної багатозадачної роботи з агентами.

Команди вміщуються в три рядки, користь негайна: ваші агенти перестають переписувати один одного. Додайте перегляд, який показує, який з них потребує вас, і ви дійсно можете тримати п'ять завдань паралельно, не втрачаючи розуму.