Worktrunk CLI
CLI для git worktree, заточенный под параллельные сессии Claude Code и Codex: команда wt, плагин и хуки автоматизации
- 12 475 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Хуки выполняют произвольные локальные команды при создании и удалении воркотри
Установка
- Работает в
Ручная установка
brew install worktrunk && wt config shell installДоступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хуки выполняют произвольные локальные команды при создании и удалении воркотри
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Worktrunk адресует рабочие копии по имени ветки, а путь к папке считает по настраиваемому шаблону. Команда wt switch -c feat создает ветку и worktree и переходит в него, флаг -x запускает после этого программу, например claude, а аргументы после двух дефисов уходят ей как первый запрос. Команда wt list показывает ветки с отметками индекса, отставания от main и непушнутых коммитов, а wt list --full добавляет статус CI и краткие описания веток от LLM. Команда wt merge делает squash, rebase на целевую ветку, быстрое слияние и удаление worktree с веткой, wt remove убирает рабочую копию без ручной цепочки из трех git-команд. Хуки в wt.toml (post-start, pre-merge, post-merge и другие) запускают скрипты вроде установки зависимостей, а wt step copy-ignored переносит target/ и node_modules/ между копиями на файловых системах APFS, btrfs и XFS.
Для кого. Для разработчиков, которые запускают несколько параллельных сессий Claude Code или Codex над одним репозиторием и устали вручную заводить worktree.
Подходит, если
- Вы раздаете трем агентам задачи вроде «авторизация», «пагинация», «тесты API» и хотите одной строкой wt switch -x claude -c feature-a запускать каждого в своей ветке и папке
- Новый worktree должен сразу собираться: хук post-start ставит зависимости, копирует кэш сборки, поднимает dev-сервер на порту, который шаблон hash_port выдает по имени ветки
- Нужна сводка по десяти открытым веткам: что в индексе, сколько коммитов впереди main, где упал CI
- Вы закрываете задачу локально: wt merge main сжимает коммиты, пишет сообщение через вашу LLM и чистит за собой
- Команда работает через pull request, и по номеру нужно быстро перейти в чужую ветку командой wt switch pr:123
Не подходит, если
- Задача одна, рабочая копия одна: хватит обычной ветки, а для разовых параллельных сессий проще Claude Squad, который сам разводит сессии по worktree
- Нужна панель с терминалами агентов и запуск сессий в одном окне: смотрите Orca или Octogent, Worktrunk терминалы не рисует
- Репозиторий не на git или хуки с произвольными командами запрещены политикой команды
Пример запроса к агенту
Создай worktree feature-auth от main через wt switch --create, поставь зависимости хуком post-start и покажи wt list, чтобы я увидел статус рядом с mainОграничения
Доступ: расширенный. Утилита работает локально в вашем репозитории и управляет ветками, папками worktree и коммитами, а хуки из wt.toml и пользовательского конфига выполняют любые команды вашей оболочки при создании, слиянии и удалении копий, поэтому читайте чужой wt.toml перед первым запуском. Для смены директории нужна шелл-интеграция: wt config shell install. На Windows wt совпадает с командой Windows Terminal, и Winget ставит программу как git-wt. Общий кэш сборки работает только на APFS, btrfs и XFS. Сообщения коммитов через LLM требуют вашего провайдера модели, плагин Claude Code необязателен. Лицензия MIT или Apache-2.0.
Как отключить. Удалите плагин через /plugin в Claude Code и удалите бинарник: brew uninstall worktrunk.
Частые вопросы
Чем это отличается от обычного git worktree?
Worktrunk сводит частые связки git worktree add, cd и remove к командам wt switch и wt remove, считает пути по шаблону и добавляет хуки, таблицу статусов и общий кэш сборки. Внутри все равно лежат настоящие worktree, поэтому git их видит.
Нужен ли плагин Claude Code, если я использую только CLI?
Нет, wt работает самостоятельно. Плагин ставится командами /plugin marketplace add max-sixty/worktrunk и /plugin install worktrunk@worktrunk и добавляет справку по хукам и конфигу, а также индикаторы активных сессий в wt list.
Как проверить, что установка прошла?
Выполните wt switch --create test-branch в любом git-репозитории: должна появиться папка рядом с проектом, а оболочка перейти в нее. Если директория не сменилась, значит не выполнена команда wt config shell install.
Как запустить сразу несколько агентов?
Повторите команду wt switch -x claude -c имя-ветки -- 'текст задачи' для каждой задачи. Флаг -x запускает программу после создания копии, а все после двух дефисов она получает как аргументы.
Что делать на Windows, если wt открывает Windows Terminal?
Поставьте через winget install max-sixty.worktrunk и пользуйтесь командой git-wt, начав с git-wt config shell install. Второй путь описан в README: отключить псевдоним приложения Terminal в параметрах Windows.
Чем Worktrunk отличается от Claude Squad?
Worktrunk управляет только worktree, хуками и слиянием и не берет на себя терминалы агентов. Claude Squad ведет сами сессии агентов, каждую в своей рабочей копии.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI и TUI на Rust: агенты в контейнерах, параллельные вкладки, сценарии из TOML от задачи до PR и отряд по расписанию
Скилл раскладывает правки на логичные коммиты по Conventional Commits и безопасно ведет ветки, отправку и pull request.
CLI создает для каждой фичи свое рабочее дерево Git и окружение, чтобы агенты и люди работали параллельно без конфликтов
Плагин для терминала Tern: одна панель на все ветки в работе с ворктри, агентами, PR и тикетами, плюс скилл Visualize PR.
Навык и плагин для Git и GitHub: ветки, Conventional Commits и путь запроса на слияние до зеленого мержа.
Grove открывает сессию Zellij: по вкладке на каждый git worktree, в каждой LazyGit, оболочка и ИИ-агент.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
Коротко о README
README описывает Worktrunk как CLI для git worktree, спроектированный под параллельный запуск AI-агентов вроде Claude Code и Codex. Три основных команды заменяют привычную возню с git worktree add/remove/switch, есть хуки на разные этапы жизненного цикла воркотри и копи-он-райт кэш сборки. Установка через Homebrew, Cargo, Winget, pacman или conda-forge. Отдельно описан плагин для Claude Code с индикаторами активных сессий в wt list и справкой по настройке хуков и LLM-коммитов. Лицензия MIT или Apache-2.0.
Бейдж для README
Исходный SKILL.md
--- name: worktrunk description: Guidance for Worktrunk (the `wt` CLI) — git worktree management, hooks, and config. Load when working out which worktree a `wt` command will act on, or reaching for the global `-C <path>` to target one; editing .config/wt.toml or ~/.config/worktrunk/config.toml; adding, modifying, or debugging hooks (post-merge, post-start, pre-commit, pre-merge, post-switch, etc.); configuring commit message generation or command aliases; or troubleshooting wt behavior. Also answers general worktrunk/wt questions. license: MIT OR Apache-2.0 compatibility: Requires the `wt` CLI (https://worktrunk.dev) --- # Worktrunk Help users work with Worktrunk, a CLI tool for managing git worktrees.