Repolode
satococoa

satococoa/wtp

CLI для Git worktree: автоматически формирует пути по именам веток, запускает хуки настройки и удаляет worktree вместе с ветками.

Звёзды
636
Форки
25
Открытые issues
27
Последний коммит
3 дня назад

Что это?

wtp (Worktree Plus) — CLI-инструмент, который дополняет git worktree удобными функциями для управления несколькими ветками, одновременно открытыми в отдельных рабочих каталогах. Команда wtp add feature/auth создаёт worktree по пути, сформированному на основе имени ветки, поэтому разработчикам не приходится вручную вводить длинные относительные пути. Кроме того, инструмент может автоматически переключаться на ветки, существующие только в удалённом репозитории, и сообщает об ошибке, если ветка есть сразу в нескольких remote.

Инструмент добавляет настройки на уровне проекта через файл .wtp.yml. Хуки после создания могут копировать из основного worktree файлы, игнорируемые Git, например .env, создавать символические ссылки на общие каталоги вроде .bin и запускать команды настройки, такие как npm ci или миграции базы данных. wtp remove --with-branch удаляет worktree вместе с его веткой за один шаг, а wtp cd переходит к worktree по имени; для Bash, Zsh и Fish доступно автодополнение.

wtp написан на Go и распространяется через Homebrew, go install и готовые бинарные файлы для Linux и macOS. Требуется Git версии 2.17 или новее.

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

  • 01Автоматически формирует пути к worktree на основе имён веток.
  • 02Удаляет worktree вместе с его веткой с помощью wtp remove --with-branch.
  • 03Запускает хуки после создания, чтобы копировать файлы, создавать символические ссылки и выполнять команды настройки.
  • 04Автоматически отслеживает удалённые ветки, если локальной ветки нет.
  • 05Предоставляет команду wtp cd с автодополнением для Bash, Zsh и Fish.

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

  • Одновременная работа над несколькими функциональными ветками без использования stash.
  • Подготовка новых worktree с файлами .env и установкой зависимостей в проектах на микросервисной архитектуре или в монорепозиториях.
  • Удаление завершённых функциональных веток вместе с их worktree.

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

  1. 1

    Установите с помощью Homebrew (macOS/Linux)

    brew install satococoa/tap/wtp
  2. 2

    Или установите с помощью Go

    go install github.com/satococoa/wtp/v2/cmd/wtp@latest
  3. 3

    Создайте worktree с новой веткой

    wtp add -b feature/new-feature

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

  • Требуется Git версии 2.17 или новее.
  • Предварительно собранные бинарные файлы доступны только для macOS с Apple Silicon и Linux, но не для Mac с Intel и Windows.

В подборках

Темы

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

Что такое wtp?
CLI для Git worktree: автоматически формирует пути по именам веток, запускает хуки настройки и удаляет worktree вместе с ветками. wtp (Worktree Plus) — CLI-инструмент, который дополняет git worktree удобными функциями для управления несколькими ветками, одновременно открытыми в отдельных рабочих каталогах. Команда wtp add feature/auth создаёт worktree по пути, сформированному на основе имени ветки, поэтому разработчикам не приходится вручную вводить длинные относительные пути. Кроме того, инструмент может автоматически переключаться на ветки, существующие только в удалённом репозитории, и сообщает об ошибке, если ветка есть сразу в нескольких remote.
wtp можно использовать бесплатно? Какая у него лицензия?
wtp распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
wtp всё ещё поддерживается?
Активно поддерживается. Последний коммит в wtp — 3 нояб. 2026 г..
Для чего можно использовать wtp?
Одновременная работа над несколькими функциональными ветками без использования stash. Подготовка новых worktree с файлами .env и установкой зависимостей в проектах на микросервисной архитектуре или в монорепозиториях. Удаление завершённых функциональных веток вместе с их worktree.
Как установить wtp?
Установите с помощью Homebrew (macOS/Linux): brew install satococoa/tap/wtp Или установите с помощью Go: go install github.com/satococoa/wtp/v2/cmd/wtp@latest Создайте worktree с новой веткой: wtp add -b feature/new-feature
Где скачать wtp?
Исходный код и инструкции по установке — на GitHub: https://github.com/satococoa/wtp

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

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