Менеджер git worktree
для Claude Code, Codex і будь-якого CLI-агента
Позначте один прапорець у тікеті або виберіть worktree, коли додаєте агента, і він працює у власній робочій копії на власній гілці. Кілька агентів редагують той самий репозиторій одночасно, не торкаючись файлів одне одного.
Перед стартом агента AgentsRoom встановлює залежності та копіює ваші файли .env у новий worktree, щоб агент одразу міг зібрати проєкт і запустити тести. Коли він закінчить, ви переглядаєте, комітите, пушите та зливаєте цей worktree на вкладці «Зміни», на комп'ютері або з телефона.
- Бекенд-агент.worktrees/fix-login-redirectПідготовлено
- Фронтенд-агент.worktrees/settings-dark-modeУ роботі
- QA-агент.worktrees/agents/qaПерегляд
Три агенти, три worktree, один репозиторій: кожна робоча копія готується до старту свого агента, потім переглядається і зливається окремо.
Два агенти в одній робочій копії, це дві людини, які друкують в одному файлі. Один запускає форматер, поки інший на середині правки, один перемикає гілку просто з-під іншого, а diff, який ви переглядаєте в кінці, змішує обидві задачі. Git worktree це виправляє: друга робоча копія того самого репозиторію, у власній папці та на власній гілці, зі спільною історією, але без спільних файлів.
Створити його можна однією командою git. Складно жити з десятьма такими: у свіжому worktree немає ні node_modules, ні .env, тож перша збірка агента падає; ніщо не підказує, який агент де працює; а коли роботу завершено, ще треба знайти папку, переглянути її, закомітити та злити назад.
AgentsRoom бере цей цикл на себе. Тікет беклогу або агент запитує worktree, AgentsRoom створює його від актуальної базової гілки всередині проєкту в .worktrees/, готує його, запускає в ньому агента і дає вам селектор на вкладці «Зміни», щоб переглянути, закомітити, запушити та злити його. Усе працює однаково, хоч би який CLI запускав агента: Claude, Codex, GitHub Copilot CLI, Cursor та 10 інших CLI-агентів.
Worktree залишаються необов'язковими. Агент без worktree працює в папці проєкту, як і раніше, а ви вирішуєте окремо для кожного тікета, агента чи шаблону агента.
Що робить менеджер worktree
Від моменту, коли завдання запитує ізольовану робочу копію, до моменту, коли її гілку злито назад.
Один worktree на тікет беклогу
Позначте в тікеті «Кодувати в окремому робочому дереві для цього завдання», виберіть один із worktree проєкту або введіть назву нової гілки, і запуск тікета створює worktree та запускає в ньому агента.
Вибір worktree під час додавання агента
Картка «Робочий простір» у вікні «Додати агента» пропонує «Головна», наявні worktree проєкту та «Нове». Worktree, який ви створили самі через git worktree add, теж є в списку.
Новий worktree для кожного агента із шаблону
Увімкніть «Нова робоча гілка для кожного агента» у збереженого агента або профілю за замовчуванням, і кожен агент, запущений із нього, отримує власну гілку з назвою agents/<шаблон>, потім -2, -3, тож копії ніколи не ділять одну робочу копію.
Готовий до збірки з першого запуску
Перед стартом першого агента в новому worktree AgentsRoom копіює потрібні йому файли, які ігнорує git (за замовчуванням усі файли .env), і запускає команду встановлення, визначену за вашим lock-файлом: yarn, pnpm, npm, bun, uv, poetry, pipenv, bundle або composer.
Перегляд, коміт і push кожного worktree
Селектор «Робоче дерево» вгорі вкладки «Зміни» перемикає diff, перегляд, «Коміт», «Завантажити» та «Відправити» на цю робочу копію. Клік на плашку агента, який має власний worktree, відкриває його напряму.
Зливається назад, коли тікет готовий
З опцією «Автоматично зливати в поточну гілку, коли завдання виконано» переведення тікета в Done зливає його гілку. Увімкніть «Автоматично робити коміт після завершення роботи», щоб те, що агент залишив без коміту, теж потрапило в злиття.
Як це працює
Шлях одного тікета, від форми до злиття.
- 1
Запросіть worktree у тікеті
У формі тікета, у розділі «Виконання», позначте «Кодувати в окремому робочому дереві для цього завдання». Виберіть наявний worktree серед чипів або залиште поле «Назва гілки»: воно заповнюється із заголовка, доки ви його не зміните, і стає новим worktree під час старту завдання.
- 2
Запустіть тікет
AgentsRoom отримує базову гілку (гілку remote за замовчуванням або гілку, задану в полі «Базова гілка робочих дерев» у налаштуваннях проєкту), створює worktree в .worktrees/<гілка>/ і додає цю папку до .git/info/exclude клону, тож вона ніколи не з'являється як невідстежувані файли у вашій основній робочій копії.
- 3
Worktree підготовлено, потім стартує агент
Термінал агента показує команду встановлення та її вивід, сповіщення повідомляє, скільки ігнорованих файлів скопійовано, потім у worktree запускається CLI агента. Це відбувається один раз на worktree; невдале встановлення ніколи не блокує агента, помилка залишається в його терміналі.
- 4
Перегляньте та злийте
Виберіть worktree на вкладці «Зміни», щоб прочитати diff і закомітити. Переведіть тікет у Done, і з увімкненим автоматичним злиттям його гілку буде злито в поточну гілку; підтвердження показує результат. Сам worktree залишається на диску для останнього погляду.
Claude Code і Codex уже створюють worktree. Ось у чому різниця.
Claude Code має власний прапорець: claude --worktree feature-auth створює .claude/worktrees/feature-auth на гілці worktree-feature-auth, копіює файли, які ігнорує git і перелічено у файлі .worktreeinclude, і під час виходу питає, залишити чи видалити worktree. Його документація прямо каже, що worktree, це свіжа робоча копія і що залежності ви встановлюєте самі або просите про це Claude. Субагенти також можуть отримати по worktree з isolation: worktree.
Застосунок Codex керує worktree в $CODEX_HOME/worktrees, запускає їх у detached HEAD від вибраної гілки, теж читає .worktreeinclude, запускає скрипти налаштування локального середовища, якщо ви його вибрали, і за замовчуванням зберігає 15 останніх. Handoff переносить чат і його код між Local і worktree. У codex-cli 0.162.1 теж є прапорець --worktree.
Обидва хороші, і обидва належать одному вендору. AgentsRoom їх не замінює: він піднімає ту саму ізоляцію на рівень вище, туди, де живуть ваші тікети та агенти, одразу для всіх CLI, готує робочу копію до того, як її побачить агент, і тримає перегляд, коміт і злиття у вікні, яким ви вже користуєтеся. Перевірено на Claude Code 2.1.299 і codex-cli 0.162.1, жовтень 2026.
Що варто знати
- Worktree ніколи не видаляється автоматично, навмисно, щоб ви могли його переглянути. Вони накопичуються в .worktrees/; видаліть непотрібний через git worktree remove, коли закінчите, але ніколи, поки всередині ще працює агент.
- Автоматичне злиття, яке натрапило на конфлікт, записує попередження, і тікет однаково переходить у Done: таке злиття треба розв'язати вручну.
- Для worktree потрібен git-репозиторій у корені проєкту. Папка, яка просто об'єднує кілька репозиторіїв поруч, їх не отримує: відкрийте кожен репозиторій як окремий проєкт.
- Проєкт, відкритий на SSH-сервері, отримує свої worktree на сервері, без кроку встановлення. Локальна робоча копія, агенти якої працюють на віддаленому хості, не може використовувати worktree, і тікет повідомляє про це замість запуску.
- QA-агент ніколи не отримує власного worktree: він тестує в робочій копії свого головного агента, бо свіжий worktree не містив би незакомічену роботу, яку треба протестувати.
Часті запитання
Що таке git worktree і навіщо давати його AI агенту?
Git worktree, це друга робоча копія того самого репозиторію, у власній папці та на власній гілці, зі спільною історією та спільним remote з вашою основною робочою копією. Якщо дати по одному кожному AI агенту для кодування, кожен агент редагує, збирає і комітить власну копію файлів, тож два агенти, які працюють одночасно, ніколи не перезаписують роботу одне одного і не перемикають гілку одне в одного з-під ніг. У нашому блозі є докладний посібник про git-частину: Git worktrees: основа для запуску декількох AI агентів без конфліктів.
Чи має Claude Code вбудовані worktree?
Так. claude --worktree <назва> (або -w) створює .claude/worktrees/<назва> на гілці worktree-<назва>, копіює файли, які ігнорує git і перелічено в .worktreeinclude, і під час виходу питає, залишити чи видалити worktree; субагенти можуть працювати у власному worktree з isolation: worktree. Залежностей він не встановлює. В AgentsRoom можна й далі ним користуватися або дозволити тікету чи агенту запросити worktree, що заодно підготує його та покаже на вкладці «Зміни» (перевірено на Claude Code 2.1.299).
Чи підтримує Codex worktree?
Застосунок Codex підтримує: він створює керовані worktree в $CODEX_HOME/worktrees, у detached HEAD, копіює ігноровані файли з .worktreeinclude, може запускати скрипти налаштування локального середовища, зберігає 15 останніх і переносить чат між Local і worktree через Handoff. У codex-cli 0.162.1 є прапорець --worktree, який запускає сесію в новому керованому worktree. AgentsRoom дає агенту Codex worktree так само, як будь-якому іншому агенту, з тікета або з вікна «Додати агента».
Які CLI-агенти можуть працювати у worktree AgentsRoom?
Усі: worktree, це просто робоча папка агента, хоч би який CLI в ній працював, тож Claude, Codex, GitHub Copilot CLI, Cursor та 10 інших CLI-агентів працюють у ньому однаково. Kimi Code і Antigravity CLI довіряють папці за її точним шляхом; AgentsRoom перед запуском записує новий worktree як довірений для них, щоб вони не зупинялися на питанні про довіру.
Чи треба запускати yarn install і копіювати мій .env у кожен worktree?
Ні. Перед стартом першого агента в новому worktree AgentsRoom копіює файли основної робочої копії, які ігнорує git і які відповідають полю «Файли, що копіюються з цієї робочої копії» (за замовчуванням усі файли .env), і запускає команду встановлення, визначену за lock-файлом у корені. Обидва параметри задаються в розділі «Налаштування проєкту» > Git > «Готувати нові worktree», де можна замінити команду, наприклад на pnpm install && pnpm build:deps. Файл, який уже є у worktree, ніколи не перезаписується.
Як переглянути та злити те, що агент зробив у своєму worktree?
Відкрийте вкладку «Зміни» і виберіть worktree в селекторі «Робоче дерево» вгорі: список файлів, diff, перегляд, «Коміт», «Завантажити» та «Відправити» тоді працюють із цією робочою копією. Для тікета опція «Автоматично зливати в поточну гілку, коли завдання виконано» зливає його гілку, коли ви переводите його в Done, а «Автоматично робити коміт після завершення роботи» («Налаштування» > «Беклог») спершу комітить те, що залишив агент, щоб злиття забрало всю роботу.
Де знаходяться worktree і чи очищаються вони?
Усередині проєкту, в .worktrees/<гілка>/, вони створюються від гілки remote за замовчуванням, якщо ви не задали гілку в полі «Базова гілка робочих дерев» у налаштуваннях проєкту. Папка додається до .git/info/exclude клону, ніколи не до вашого .gitignore, тож вона не потрапляє у ваші коміти. Worktree ніколи не видаляються автоматично: видаліть непотрібний через git worktree remove, коли закінчите з ним.
Чи можна користуватися worktree з телефона або на віддаленому сервері?
Так, і там, і там. На телефоні екран «Зміни» має той самий селектор worktree, а тікет, який запитує worktree, працює в ньому, коли ви запускаєте його з телефона, і підготовлений комп'ютером, як будь-який інший. Проєкт, відкритий на SSH-сервері, отримує свої worktree на сервері, без кроку встановлення. Локальна робоча копія, агенти якої працюють на віддаленому хості, не може використовувати worktree, і тікет повідомляє вам про це замість запуску.
Корисні матеріали
Git worktrees: основа для запуску декількох AI агентів без конфліктів
Ваші агенти перезаписують один одного, коли працюють паралельно. Git worktrees вирішують це за допомогою двох команд. Ось як їх використовувати.
Десять агентів запустили ту саму перевірку типів водночас. Розв'язком виявилася тека.
Сімнадцять кодових агентів в одному чекауті, десять процесів tsc паралельно, load average 37 і 87 МБ вільної пам'яті. Перевірка типів на дев'яносто секунд забрала 7 хв 36. Ось виміри, пояснення того, чому машина не рахувала, і маленьке спільне блокування, яке все виправило. Копіюється в будь-який репозиторій.
Як запускати від 3 до 8 кодових агентів паралельно без втрати контролю
Запускати кілька агентів Claude Code або Codex одночасно легко. Контроль : це те, де все розвалюється. Ось метод, який дійсно працює.
Вам також може сподобатися
Управління завданнями
Візуальна канбан-дошка для оркестрації AI агентів з перетягуванням. Створюйте завдання в TODO, перетягуйте їх в In Progress, щоб автоматично запустити агента Claude, і відстежуйте виконання через колонки Pending і Done. Розробка, керована беклогом, для паралельного AI кодування.
Перегляд за агентом
Переглядайте зміни в коді від кожного AI агента окремо. AgentsRoom відстежує, який агент Claude Code змінив які файли. Фільтруйте відмінності за агентом, переглядайте індивідуально, комітьте за агентом для чистої історії git.
Багатопроєктний · Багатоагентний · Паралельний
AgentsRoom запускає кілька агентів Claude, Codex, GitHub Copilot CLI, Cursor та 10 інших CLI-агентів паралельно в різних проєктах, все в одному вікні. Ролі з кольоровим кодуванням, статус у реальному часі, лічильники для кожного проєкту, нативні сповіщення на робочому столі та мобільних пристроях. Візуальна альтернатива 12 вкладкам терміналу та хаосу сесій Claude Code, розкиданих по iTerm2, Warp та tmux.
Налаштуйте агентів
Обирайте з 14 вбудованих ролей агентів, додавайте спеціалістів з The Agency або створюйте власного AI-кодуючого агента з його власним системним запитом. Потім діліться своїми агентами з командою через чат і публікуйте їх у спільноті, щоб усі разом підвищували рівень.
Мультиагентний робочий процес • Передача • Цикл зворотного зв'язку
Команди агентів AgentsRoom об'єднують AI агентів кодування, як справжня інженерна команда. Візуальний редактор робочих процесів (полотно у стилі n8n) для з'єднання ролей Dev, QA, PM, Security та DevOps. Автоматична передача з резюме функцій, git diff, ризиками та підказками для тестування. Машинно-перевірені ворота якості (ваш тестовий набір вирішує, а не агент), паралельні гілки огляду QA та Security, умовні зв'язки, цикли зворотного зв'язку, захист max-cycles. Обирайте для кожної команди, як працюють ролі: один агент, який змінює роль за роллю і тримає весь контекст, або по живому агенту на роль, що пишуть одне одному в реальному часі. Мультиагентний оркестратор, якого не вистачало вашим агентам Claude, Codex, GitHub Copilot CLI, Cursor та 10 іншим CLI-агентам.
Дайте кожному агенту власну робочу копію
Завантажте AgentsRoom для macOS, Windows або Linux, і нехай кілька агентів працюють в одному репозиторії, не заважаючи одне одному.
Додаток-компаньйон: контролюйте своїх агентів на ходу
Використовуйте свого: Claude, Codex, Antigravity CLI або іншого AI-провайдера.
Надсилайте баги та запити прямо у свій публічний беклог.