# worktree

Команда создаёт отдельную папку git worktree для работы над фичей или фиксом. Полезна, когда нужно параллельно вести несколько задач без конфликтов в основной ветке.

- команда · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 6529 у репозитория
- Автор: FlorianBruniaux
- Лицензия: CC-BY-SA-4.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/FlorianBruniaux/claude-code-ultimate-guide/tree/HEAD/.claude/commands/worktree.md
- Обновлён: 2026-10-22
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/commands/worktree

## Что делает

Команда `/worktree` автоматизирует создание изолированного рабочего пространства на базе git worktree. Вы задаёте имя ветки в формате `префикс/описание` (например, `feature/pr-9-skill-improvements`), а скрипт создаёт папку `.worktrees/префикс-описание`, проверяет, добавлен ли `.worktrees/` в `.gitignore`, и переходит на новую ветку.

Скрипт валидирует имя ветки, отклоняя пробелы и зарезервированные git-символы. Есть флаг `--fast` для пропуска проверки `.gitignore`. Если ветка уже существует, worktree её переиспользует. По завершении команда подсказывает, как переключиться в новую папку и запустить Claude там.

Для удаления используйте `/remove-worktree` (конкретный worktree) или `/clean-worktrees` (все слитые). Это удобно при параллельной разработке или когда вы работаете в документации и хотите проверить разные версии одновременно.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/commands/worktree.md` — Вызов — /worktree. Для всех проектов — ~/.claude/commands/

### Codex

**Вручную: положить файлы**
- Файл: `~/.codex/prompts/worktree.md` — Вызов — /prompts:worktree. В Codex этот формат помечен устаревшим, замена — скиллы

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/prompts/worktree.prompt.md`

### Gemini CLI

**Вручную: положить файлы**
- Файл: `.gemini/commands/worktree.toml` — Gemini хранит команды в TOML: текст запроса — в поле prompt

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/FlorianBruniaux/claude-code-ultimate-guide/tree/HEAD/.claude/commands/worktree.md

## Когда брать
- Создать отдельную ветку для фичи без конфликтов с основной кодовой базой
- Работать параллельно над несколькими задачами в разных папках
- Быстро переключаться между изолированными рабочими окружениями
- Автоматически добавить `.worktrees/` в `.gitignore` при первом запуске

## Примеры запросов агенту
- Создай worktree для фичи: `/worktree feature/pr-9-skill-improvements`
- Создай worktree для фикса: `/worktree fix/typo-in-guide`
- Создай worktree с пропуском проверки gitignore: `/worktree feat/new-section --fast`

## Похожие
- [worktree-init](https://affpapa.org/nevibecode/commands/worktree-init.md) — команда · 94 установки
- [worktree-check](https://affpapa.org/nevibecode/commands/worktree-check.md) — команда · 81 установка
- [git-worktree-runner](https://affpapa.org/nevibecode/skills/git-worktree-runner.md) — скилл · ★ 1636 у репозитория
- [branch-finalization](https://affpapa.org/nevibecode/skills/branch-finalization.md) — скилл · 131 установка
- [ce-worktree](https://affpapa.org/nevibecode/skills/ce-worktree.md) — скилл · 3200 установок
- [git-worktree-isolation](https://affpapa.org/nevibecode/skills/git-worktree-isolation.md) — скилл · 2300 установок

Из того же набора: [florianbruniaux/claude-code-ultimate-guide](https://affpapa.org/nevibecode/by/florianbruniaux/claude-code-ultimate-guide.md) — 45 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
