К основному содержанию
команда

worktree-init — команда для Claude Code: параллельные worktrees

Раскладывает несколько задач по отдельным git worktree, чтобы каждая шла в своём окне Ghostty со своим Claude.

Установить в Claude Code · Через claude-code-templates Все способы и платформы ↓
npx claude-code-templates@latest --command git-workflow/worktree-init
Открыть на GitHub

Что делает worktree-init

Команда принимает список задач через |, проверяет, что вы внутри git-репозитория, и заводит под каждую отдельную ветку вида claude/<имя-задачи> с рабочим каталогом в ../worktrees/<repo>/claude-<имя>. Внутри нового worktree появляется файл .worktree-task.md с описанием задачи, веткой и датой создания. В конце выводится таблица с путями и готовые строки для вставки в панели Ghostty.

Перед созданием команда проверяет чистоту рабочего дерева через git status --porcelain. Если есть незакоммиченные изменения, она предупредит и спросит, продолжать ли. Дальше идёт git fetch origin, а базовой веткой берётся main или master — что найдётся в origin/HEAD.

Если в корне лежит package.json, команда отметит, что в каждом worktree, скорее всего, понадобится установка зависимостей, и подскажет менеджер по локфайлу: package-lock.json, yarn.lock, pnpm-lock.yaml или bun.lockb. Это повод проверить, что зависимости вообще ставятся без конфликтов, прежде чем запускать несколько Claude сразу.

Какие задачи решает

  • развести несколько задач по отдельным веткам без ручного git worktree add
  • поднять параллельные сессии Claude в разных панелях терминала
  • зафиксировать описание задачи рядом с её рабочим каталогом
  • получить готовые команды перехода в каждый worktree
  • не забыть про установку зависимостей в новых каталогах

Примеры запросов агенту

  • /worktree-init починить логин | обновить документацию API | добавить тесты на экспорт
  • /worktree-init рефакторинг модуля оплаты | миграция на новый SDK

Как установить worktree-init

1Через claude-code-templates

npx claude-code-templates@latest --command git-workflow/worktree-init

2Вручную: положить файлы

.claude/commands/worktree-init.md

Вызов — /worktree-init. Для всех проектов — ~/.claude/commands/

Вопросы о worktree-init

Как установить worktree-init в Claude?

Через шаблоны: npx claude-code-templates@latest --command git-workflow/worktree-init. Файл команды окажется в .claude/commands/worktree-init.md.

Что делает worktree-init?

Создаёт по git worktree на каждую задачу из списка, заводит ветки claude/<имя> и печатает команды для запуска Claude в панелях Ghostty.

Как задать несколько задач?

Перечислите их в аргументе через вертикальную черту, например /worktree-init задача 1 | задача 2. Если аргумент пустой, команда спросит описания отдельно.

Исходный текст

worktree-init.md · MIT
---
allowed-tools: Bash(git:*), Bash(mkdir:*), Bash(ls:*), Bash(cat:*), Bash(basename:*), Bash(pwd:*), Bash(sed:*)
argument-hint: task 1 | task 2 | task 3
description: Create parallel worktrees for multi-task development with Ghostty panels
---

# Worktree Parallel Init

Create multiple git worktrees for parallel development: $ARGUMENTS

## Instructions

You are setting up parallel worktrees so the user can work on multiple tasks simultaneously in separate Ghostty terminal panels, each running its own Claude instance.

### Step 1: Validate Environment

1. Check this is a git repository: `git rev-parse --is-inside-work-tree`
2. Get the repo name: `basename $(git rev-parse --show-toplevel)`
3. Get the main branch name (check for `main` or `master`): `git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's@^refs/remotes/origin/@@'` — if that fails, default to `main`
4. Ensure working tree is clean: `git status --porcelain`. If dirty, warn the user and ask if they want to continue.
5. Fetch latest: `git fetch origin`

### Step 2: Parse Tasks

Parse tasks from `$ARGUMENTS`. Tasks are separated by `|` (pipe character).

If `$ARGUMENTS` is empty, use AskUserQuestion to ask the user to describe their tasks (they can provide multiple separated by `|`).

For each task description:
- Trim whitespace
- Generate a kebab-case branch name: `claude/<kebab-case-task>` (max 50 chars, alphanumeric and hyphens only)
- Generate a worktree directory path: `../worktrees/<repo-name>/claude-<kebab-case-task>`

### Step 3: Create Worktrees

For each task:

1. Create the parent directory if needed: `mkdir -p ../worktrees/<repo-name>`
2. Create the worktree:
   ```bash
   git worktree add -b claude/<name> ../worktrees/<repo-name>/claude-<name> origin/<main-branch>
   ```
3. Write a `.worktree-task.md` file inside the new worktree with this content:
   ```markdown
   # Worktree Task

   **Branch:** claude/<name>
   **Task:** <original task description>
   **Created:** <ISO date>
   **Source repo:** <path to main repo>
   ```

### Step 4: Check for Dependencies

If a `package.json` exists in the repo root, note that each worktree may need `npm install` (or the appropriate package manager).

Check for:
- `package-lock.json` → npm install
- `yarn.lock` → yarn install
- `pnpm-lock.yaml` → pnpm install
- `bun.lockb` → bun install

### Step 5: Output Summary

Display a clear summary table:

```
| # | Task | Branch | Path |
|---|------|--------|------|
| 1 | ... | claude/... | ../worktrees/repo/claude-... |
```

Then display ready-to-copy commands for Ghostty panels. For each worktree:

```
# Panel <N>: <task description>
cd <absolute-path-to-worktree> && claude
```

If dependencies were detected, add a note:
```
# Note: Run <package-manager> install in each worktree before starting
```

Finally, remind the user:
- Open a new Ghostty panel with `Cmd+D` (split right) or `Cmd+Shift+D` (split down)
- When done with a task, use `/worktree-deliver` to commit, push, and create a PR
- After merging all PRs, use `/worktree-cleanup --all` from the main repo

© davila7 · MIT · davila7/claude-code-templates

Похожие слэш-команды

Все слэш-команды по теме «Git и GitHub» →
git-worktree-manager Alireza Rezvani Разводит параллельные ветки по отдельным worktree с собственными портами и окружением, чтобы агенты не мешали друг другу. 581установок git-worktree-runner dyoshikawa Скилл учит агента управлять git worktree через CLI-обёртку gtr: создавать, открывать в редакторе, запускать команды и удалять. CX Codex +1 ★ 1 552звёзд репо parallel-feature-development Seth Hobson Скилл помогает разделить большую фичу между агентами, закрепить файлы и свести результаты без лишних конфликтов. Подходит для параллельной работы над слоями и вертикальными срезами. CX Codex 9 900установок cmux-ghostty manaflow-ai Регламентирует работу с сабмодулем Ghostty и сборку GhosttyKit в репозитории cmux. Пригодится при синхронизации форка и обновлении указателей Git. CX Codex +1 4 700установок paseo-handoff getpaseo Передаёт текущую задачу новому агенту вместе с контекстом, решениями и файлами. Пригодится, когда нужно продолжить работу в чистой сессии или в отдельном git worktree. CX Codex +1 4 900установок om-auto-create-pr-loop open-mercato Создаёт PR по развёрнутому описанию задачи, ведёт план и фиксирует прогресс по шагам. Нужен для длинных изменений, которые важно продолжать без потери контекста. CX Codex +1 3 700установок

Из того же набора205

Весь набор →
discord-bot-architect Помогает писать ботов для Discord на JavaScript и Python: слэш-команды, кнопки, меню, шардинг. Пригодится, когда бот выходит за пределы учебного примера. 106установок move-code-quality Разбирает пакеты на языке Move по чек-листу качества из Move Book и подсказывает, что поправить под Move 2024 Edition. 100установок doc Скилл для чтения, создания и правки документов .docx, когда важна вёрстка: таблицы, разрывы страниц, шрифты. Полезен, если документ уходит клиенту. 99установок statsmodels Скилл для регрессий, GLM, временных рядов и проверки гипотез прямо в Claude. Пригодится, когда нужен вывод по коэффициентам, а не только предсказание. 97установок multimodal-whisper Скилл для Claude, который подключает модель Whisper: расшифровка аудио на 99 языках, перевод на английский и определение языка. 91установок appinsights-instrumentation Подключает веб-приложение к Azure App Insights: команда сама разберётся в стеке проекта и добавит отправку телеметрии. 91установок salesforce-development Скилл с рабочими паттернами для разработки на платформе Salesforce: LWC, Apex, REST и Bulk API, Salesforce DX. Пригодится, когда агент пишет код под Salesforce. 90установок worktree-check Показывает, в каком worktree вы находитесь, на какой ветке, сколько коммитов впереди main и что за задача назначена. 81установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой