Крошечный CLI для борьбы с хаосом AI-агентов

Запуск нескольких AI-агентов в одном Git-чекауте — это неизбежное столкновение. Агент А в процессе рефакторинга внезапно ломает тесты Агента Б из-за общих зависимостей или конфликтующих правок файлов. Эта проблема общей папки парализует параллельную разработку.

Git worktrees предлагают мгновенное решение: каждая задача получает изолированную директорию, свою ветку и чистое рабочее пространство. Этот второй чекаут использует общую историю репозитория, но агенты больше не пишут на одном и том же листе бумаги. Это мощный примитив для распараллеливания работы.

Однако обычные Git worktrees создают свои трудности. Создание одного требует ввода имени ветки трижды, за которым следует ручная смена директорий. Очистка требует еще трех команд для удаления worktree и его ветки.

Более того, запрос статуса в Git выдает лишь статический список путей к папкам. Нет единого динамического представления того, что делает каждый агент, нет встроенной команды слияния, а зависимости остаются заботой пользователя. Нативная поддержка worktree, как в Claude Code, исправляет создание, но всё еще оставляет эти критические пробелы.

Worktrunk оптимизирует рабочие процессы параллельных агентов, смещая фокус с путей к папкам на ветки. wt switch <branch> создает или переходит в worktree, устраняя необходимость вводить имена веток или запоминать пути к директориям. Эта единственная команда настраивает изолированную среду для каждого агента.

wt list предоставляет консолидированную интерактивную панель управления. Она отображает каждый активный worktree, показывая его ветку, прогресс относительно main, размер diff и индикаторы активности агента (например, значок робота для активных агентов, облачко с текстом для агентов, ожидающих ввода). Это заменяет статические пути к папкам из стандартного git worktree list на контекст, с которым можно работать.

Когда агент завершает свою задачу, wt merge автоматизирует сложный шестиэтапный жизненный цикл Git в одну команду. Она делает коммит, squash, rebase на main, fast-forward и удаляет завершенный worktree и его ветку. Хотя wt merge автоматизирует большую часть тяжелой работы, конфликты всё равно останавливают rebase, требуя вмешательства человека.

Запуск нескольких агентов требует эффективной настройки. Worktrunk предоставляет хуки жизненного цикла, автоматически выполняя задачи настройки при создании worktree. Это исключает повторную установку зависимостей и ручную настройку среды, гарантируя, что каждый агент начинает работу продуктивно.

Worktrunk также решает вопросы хранения и скорости с помощью wt step copy-ignored. Эта команда повторно использует игнорируемые файлы, такие как node_modules или кэши сборки. На поддерживаемых файловых системах (APFS, Btrfs) она использует copy-on-write, связывая с исходными файлами до тех пор, пока не произойдут изменения. Это значительно экономит дисковое пространство и время.

Видео демонстрирует впечатляющие результаты: папка сборки Rust объемом 14 ГБ копируется примерно за 20 секунд с помощью copy-ignored против 2 минут в обычном режиме. Первая сборка Rust сократилась с 68 секунд до 3-4 секунд. Это время, заявленное автором, а не универсальные бенчмарки. Поддержка файловой системы имеет решающее значение; EXT4 в Linux выполняет полное копирование. Кроме того, нативные модули всё еще требуют пересборки. Для получения более подробной информации о подходе Worktrunk к рабочим процессам параллельных агентов, посетите Worktrunk — Git worktree management for parallel AI agent workflows.

Оркестрация Worktrunk, ориентированная на терминал, резко контрастирует с нативными worktrees в Claude Code. В то время как Claude Code обеспечивает базовую изоляцию и автоматическую очистку, он оставляет мониторинг статуса и рабочие процессы слияния на усмотрение пользователя. Worktrunk заполняет этот пробел, предлагая единый обзор всей активности агентов и слияние одной командой, которое управляет коммитами, squash, rebase и удалением worktree.

Этот небольшой CLI находится на стадии до версии 1.0 (в настоящее время v0.81), что означает частые критические изменения; будьте готовы обновлять конфигурацию. Настройка shell-функций для переключения директорий критически важна, как и проверка проектных хуков, выполняющих shell-команды. Нерешенные конфликты слияния по-прежнему требуют ручного вмешательства; Worktrunk останавливает rebase и передает управление вам.

Преимущества copy-on-write от команды wt step copy-ignored зависят от файловой системы. На APFS это происходит почти мгновенно и значительно экономит место, но на Linux-системах с EXT4 создаются полные копии. Нативные модули все равно потребуют пересборки в новых worktrees.

Если вы запускаете по одному агенту за раз, нативных worktrees или обычного Git, скорее всего, достаточно. Однако, если вы регулярно запускаете три, пять или более агентов и вам нужно сократить накладные расходы на worktree — от настройки и установки зависимостей до проверки статуса и очистки после слияния — Worktrunk предоставляет недостающий уровень оркестрации.

Что такое Worktrunk?

Worktrunk — это CLI с открытым исходным кодом, который упрощает управление Git worktree для разработчиков, выполняющих параллельные задачи программирования или использующих AI-агентов.

Как Worktrunk помогает при работе с параллельными AI-агентами?

Он предоставляет каждой задаче свою ветку и checkout, отображает статус worktree в одном представлении и оптимизирует процессы слияния и очистки.

Работает ли Worktrunk только с Claude Code?

Нет. Он интегрируется с Claude Code и поддерживает другие CLI агентов, включая Codex, OpenCode и Gemini CLI.

Устраняет ли Worktrunk конфликты слияния?

Нет. Worktrees изолируют файлы во время разработки, но изменения, которые пересекаются, все равно могут вызвать конфликты при слиянии.

Готов ли Worktrunk к использованию в продакшене?

Он находится на стадии до версии 1.0, поэтому ожидайте возможных критических изменений и проверяйте проектные хуки перед тем, как разрешать выполнение их shell-команд.