Git worktree — отдельная копия репозитория в своей ветке. У неё общая git-история с основным репозиторием, но свои файлы в отдельной папке. Вы можете открыть сколько угодно worktree одновременно.
какую проблему решают worktree
Обычно репозиторий — это одна папка с одной активной веткой. Чтобы работать над двумя функциями одновременно, вам пришлось бы убрать изменения в stash, переключить ветку, сделать другую работу, вернуться и восстановить stash. Это неудобно.
Worktree даёт вам вторую папку, где уже выбрана другая ветка. Работайте над функцией A в одной папке, а над функцией B — в другой. Без stash и переключений. Обе папки доступны одновременно.
почему это важно для ИИ-агентов
Если запустить двух ИИ-агентов в одной папке, они перезапишут изменения друг друга. Агент A редактирует auth.ts. Агент B тоже редактирует auth.ts. Победит тот, кто сохранит файл последним. Работа другого агента пропадёт.
Worktree решают эту проблему. Каждый агент получает свою папку, ветку и копию файлов. Оба могут одновременно редактировать auth.ts и не мешать друг другу. Когда они закончат, вы отдельно объедините каждую ветку.
как это выглядит на диске
my-project/ ← your main repo (main branch)
../my-project-feature-a/ ← worktree (feature-a branch)
../my-project-feature-b/ ← worktree (feature-b branch)
У всех трёх папок общая git-история. После слияния коммиты из одного worktree видны в остальных. Но незакоммиченные изменения файлов полностью изолированы.
как Pane это автоматизирует
Вам не придётся запускать git-команды вручную. Когда вы создаёте новую панель в Pane:
Pane создаёт worktree и ветку.
Pane копирует переменные окружения, node_modules и другие важные каталоги. Агент может сразу начать работу.
Когда вы архивируете панель, Pane автоматически удаляет worktree.
как сделать это вручную
Без Pane вам пришлось бы сделать следующее:
git worktree add ../feature-a feature-a
cd ../feature-a
claude # start your agent here
# when done:
git worktree remove ../feature-a
Git worktree — отдельная рабочая копия репозитория. У неё своя папка, ветка и файлы, но общая git-история с основным репозиторием. Вы можете одновременно открыть несколько worktree в разных ветках.
Ветка — это всего лишь указатель на коммит. В одной папке одновременно может быть выбрана только одна ветка. Worktree даёт вам вторую, третью или четвёртую папку. В каждой выбрана своя ветка. Вы можете одновременно редактировать файлы во всех папках.
Клон копирует весь репозиторий вместе с git-историей. Worktree использует общую историю с исходным репозиторием. Поэтому он почти не занимает дополнительное место и автоматически остаётся синхронизированным.
Если два агента работают с одними файлами в одной папке, они перезапишут изменения друг друга. Worktree даёт каждому агенту отдельную копию. Агент A может редактировать auth.ts в одном worktree, а агент B — в другом и на другой ветке. Конфликтов не будет.
Да. Когда вы создаёте панель с включёнными worktree, Pane запускает git worktree add, настраивает ветку, копирует переменные окружения и node_modules. При архивации панели Pane всё удаляет.
Да. Отключите «Использовать worktree» в окне создания панели. Агент будет работать в основном рабочем дереве, а не в изолированной ветке. Это удобно для быстрых разовых задач, где изоляция не важна.
Да. Каждый worktree получает весь монорепозиторий. Агенты могут параллельно работать над разными пакетами. Назначьте каждому агенту папку его пакета, и они не будут мешать друг другу.
Предупреждение Windows SmartScreenПри прямом скачивании может появиться предупреждение SmartScreen, пока у Pane нет подписи. Исходный код Pane полностью открыт. Вы можете проверить его или собрать приложение сами.1. Нажмите «Подробнее»2. Нажмите «Выполнить в любом случае»3. Продолжите установкуУстановка через PowerShell скачивает официальный релиз напрямую и позволяет избежать большинства проблем с загрузкой через браузер.глобальная установка через npm