Repolode
coderabbitai

coderabbitai/git-worktree-runner

Bash CLI для управления git worktree: создание, настройка и удаление рабочих деревьев для веток, а также запуск редакторов и AI-агентов.

Звёзды
1,809
Форки
114
Открытые issues
11
Последний коммит
21 час назад

Что это?

gtr (Git Worktree Runner) — CLI-инструмент, который упрощает работу с git worktree. Worktree позволяет одновременно разместить несколько веток одного репозитория в отдельных папках — например, чтобы работать над новой функцией, проверять pull request или запускать тесты на main, не переключая ветки и не убирая изменения во временное хранилище. gtr оборачивает низкоуровневые команды git worktree в более короткие, например `git gtr new`, `git gtr pr 123` и `git gtr rm`.

Каждый новый worktree можно настроить автоматически. gtr копирует файлы конфигурации и окружения, соответствующие заданным шаблонам, запускает хуки после создания — например, для установки зависимостей — и может открыть worktree в редакторе или запустить AI-инструмент для написания кода. Встроенные адаптеры поддерживают редакторы Cursor, VS Code и Zed, а также AI-инструменты Claude Code, Codex и Gemini CLI. В качестве запасного варианта можно использовать любую другую безопасную команду из PATH. Режим вывода `--porcelain` позволяет скриптам и агентам для написания кода надёжно получить путь к новому worktree.

Настройки хранятся в git config, а общие для команды значения по умолчанию можно задать в файле `.gtrconfig`. Хуки, а также настройки редактора и AI-инструментов из этого файла применяются только после подтверждения пользователя командой `git gtr trust`. Инструмент работает в macOS, Linux и Windows через Git Bash или WSL. Требуются Git 2.17+ и Bash 3.2+.

Ключевые возможности

  • 01Создание, просмотр списка, переименование и удаление worktree по имени ветки с помощью коротких команд
  • 02Добавление pull request в worktree командой `git gtr pr`
  • 03Копирование env- и конфигурационных файлов в новые worktree по шаблонам включения и исключения
  • 04Запуск хуков после создания, например для установки зависимостей
  • 05Открытие worktree в поддерживаемых редакторах или запуск AI-инструментов для написания кода с помощью встроенных адаптеров
  • 06Удаление worktree, связанных с влитыми или закрытыми PR и MR

Сценарии использования

  • Проверка pull request коллеги без прерывания текущей работы над функцией
  • Параллельный запуск нескольких AI-агентов для написания кода, каждый в своей ветке
  • Поддержание чистого worktree на main для запуска тестов или сборок
  • Стандартизация настройки отдельных веток в команде, например файлов окружения и установки зависимостей

Быстрый старт

  1. 1

    Установите через Homebrew (macOS)

    brew tap coderabbitai/tap && brew install git-gtr
  2. 2

    Или клонируйте репозиторий

    git clone https://github.com/coderabbitai/git-worktree-runner.git
  3. 3

    Запустите установщик из каталога checkout

    ./install.sh
  4. 4

    Создайте worktree для ветки

    git gtr new my-feature

Что важно знать

  • Требуются Bash 3.2 или новее и Git 2.17 или новее; Windows поддерживается только через Git Bash.
  • В Windows необходимо сохранить checkout целиком на месте: если скопировать только bin/git-gtr, программа перестанет работать.

В подборках

Темы

Частые вопросы

Что такое git-worktree-runner?
Bash CLI для управления git worktree: создание, настройка и удаление рабочих деревьев для веток, а также запуск редакторов и AI-агентов. gtr (Git Worktree Runner) — CLI-инструмент, который упрощает работу с git worktree. Worktree позволяет одновременно разместить несколько веток одного репозитория в отдельных папках — например, чтобы работать над новой функцией, проверять pull request или запускать тесты на main, не переключая ветки и не убирая изменения во временное хранилище. gtr оборачивает низкоуровневые команды git worktree в более короткие, например `git gtr new`, `git gtr pr 123` и `git gtr rm`.
git-worktree-runner можно использовать бесплатно? Какая у него лицензия?
git-worktree-runner распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
git-worktree-runner всё ещё поддерживается?
Активно поддерживается. Последний коммит в git-worktree-runner — 7 нояб. 2026 г..
Для чего можно использовать git-worktree-runner?
Проверка pull request коллеги без прерывания текущей работы над функцией Параллельный запуск нескольких AI-агентов для написания кода, каждый в своей ветке Поддержание чистого worktree на main для запуска тестов или сборок Стандартизация настройки отдельных веток в команде, например файлов окружения и установки зависимостей
Как установить git-worktree-runner?
Установите через Homebrew (macOS): brew tap coderabbitai/tap && brew install git-gtr Или клонируйте репозиторий: git clone https://github.com/coderabbitai/git-worktree-runner.git Запустите установщик из каталога checkout: ./install.sh Создайте worktree для ветки: git gtr new my-feature
Где скачать git-worktree-runner?
Исходный код и инструкции по установке — на GitHub: https://github.com/coderabbitai/git-worktree-runner

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

CLI-инструмент, который запускает локальный веб-интерфейс в стиле GitHub для просмотра и обсуждения git diff с комментариями, которые можно копировать как промпты для ИИ.

3,3 тыс.+10 за неделю215TypeScriptMITАктивно поддерживаетсяОбновлён 2 месяца назад

23 навыка в формате slash-команд и мощных инструментов превращают Claude Code в виртуальную команду с ролями CEO, дизайнера, инженерного менеджера, ревьюера, QA и специалиста по релизам.

140,6 тыс.+2,2 тыс. за неделю20,8 тыс.TypeScriptMITОбновлён 2 часа назад

Дистрибутив агентов для командной разработки: вы общаетесь с одним координатором, который распределяет задачи параллельным агентам в отдельных git worktree и сессиях в стиле tmux.

8,7 тыс.+61 за неделю2,7 тыс.ShellMITОбновлён вчера