Worktree Manager MCP
MCP-сервер к настольному менеджеру git worktree: агент создает ветки в отдельных папках и смотрит статус.
- 64 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Продвинутые инструменты коммитят и отправляют изменения в репозитории пользователя.
- Приложение умеет открывать доступ к рабочему пространству и терминалу из браузера, в том числе через туннель `ngrok`.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/worktree-managerОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Продвинутые инструменты коммитят и отправляют изменения в репозитории пользователя.
- Приложение умеет открывать доступ к рабочему пространству и терминалу из браузера, в том числе через туннель `ngrok`.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Worktree Manager состоит из настольного приложения на Tauri и пакета `@worktree-manager/mcp`. Приложение ведет рабочие пространства из нескольких репозиториев: новый worktree создается сразу во всех связанных проектах, а `node_modules`, `target` и подобные папки подключаются символическими ссылками. MCP-сервер дает агенту три слоя инструментов. Базовый слой перечисляет пространства и worktree и показывает статус. Слой деталей отдает ветки, статистику изменений и список измененных файлов. Продвинутый слой создает и архивирует worktree, делает коммит и push. Пока приложение запущено, сервер ходит к нему по локальному HTTP. Без приложения он читает файл конфигурации.
Для кого. Разработчикам, которые ведут несколько веток параллельно, запускают Claude Code, Codex или Cursor в разных worktree и хотят управлять ими из чата агента.
Подходит, если
- Срочный хотфикс прерывает работу над фичей, и нужна отдельная папка с веткой без `git stash`.
- Фронтенд, бэкенд и общая библиотека лежат в разных репозиториях, а ветку нужно завести во всех сразу.
- Агент должен сам показать, у каких worktree есть неотправленные изменения.
- Несколько агентов работают над разными ветками одного проекта и не должны мешать друг другу.
- После слияния старые worktree надо убрать в архив с проверкой незакоммиченной работы.
Не подходит, если
- Работа идет в одной ветке одного репозитория, и worktree не нужны.
- Настольное приложение ставить нельзя: без него MCP-сервер читает только файл конфигурации.
- Агенту нельзя коммитить и отправлять изменения, но подтверждение каждого вызова вы не включали.
Пример запроса к агенту
Создай worktree `feature-abc` во всех проектах рабочего пространства и покажи его статус.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Для полной работы нужно установленное приложение Worktree Manager: сборки есть для macOS, Windows и Linux. Пакету MCP требуется Node.js 18 или новее. Приложение регистрирует порт в `~/.config/worktree-manager/mcp.json`, по умолчанию 42819, а при занятости выбирает свободный из диапазона 42800–42900. Инструменты продвинутого слоя пишут в git, включая отправку в удаленный репозиторий, поэтому доступ к репозиториям нужен рабочий. Встроенное голосовое управление и генерация сообщений коммитов используют внешние сервисы с отдельными ключами.
Как отключить. Выполните `npx -y @worktree-manager/mcp uninstall` или удалите запись `worktree-manager` из `~/.claude.json`. Приложение удаляют обычным способом для вашей системы.
Частые вопросы
Как подключить Worktree Manager к Claude Code?
Выполните `npx -y @worktree-manager/mcp install`: команда ставит пакет и прописывает сервер в конфигурации Claude Code. Затем перезапустите Claude Code или выполните `claude mcp restart`.
Нужно ли держать приложение запущенным?
Для актуальных данных да: сервер связывается с приложением по локальному HTTP. Без него остается чтение файла `~/.config/worktree-manager/global.json`, и ошибка «No transport available» означает, что нет ни приложения, ни файла.
Какие действия агент может выполнять?
Базовый слой только читает: пространства, worktree, статус. Слой деталей добавляет ветки, статистику изменений и список измененных файлов. Создание и архивирование worktree, `git_commit` и `git_push` входят в третий слой.
Что такое git worktree и чем он лучше клона?
Worktree проверяет другую ветку в отдельную папку, а история, ссылки и хуки остаются общими. Отдельный клон занял бы место под репозиторий целиком.
Как использовать несколько репозиториев?
Объедините проекты в рабочее пространство в приложении. Команда создания worktree тогда заводит одноименную ветку во всех связанных репозиториях, и агент видит их вместе.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер git на 28 инструментов: агент клонирует, коммитит, ветвит, сливает и перебазирует в локальных репозиториях.
CLI для git worktree с нечетким поиском: отдельная папка на каждую ветку, чтобы несколько агентов работали параллельно без конфликтов
Менеджер git worktree на Rust с TUI: создает ветку, копирует файлы, запускает setup и показывает, где работает ИИ-агент
MCP-сервер, который дает агенту скриншоты, DOM, логи и IPC запущенного приложения на Tauri v2 и умеет кликать по интерфейсу
Локальный MCP-сервер с графом вызовов и поиском символов: агент видит структуру кода и последствия правки заранее.
MCP-сервер с графом рабочих задач и проверками на стороне сервера: агент не перейдет к работе, пока нет нужных заметок
Коротко о README
Проект позиционируется как недостающий графический интерфейс для git worktree. Кроме менеджера есть встроенный терминал, открытие в VS Code, Cursor и IntelliJ IDEA и доступ из браузера под паролем.