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

checkout — слэш-команда для Claude Code: ветки по конвенции

Команда checkout создаёт и переключает git-ветки по конвенции имён: feature/, hotfix/, release/ и другие префиксы. Пригодится там, где в проекте заведён порядок в названиях веток.

MIT ★ 763 обновлён 2026-03-31

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/commands/checkout.md
Открыть на GitHub

Что делает checkout

Команда разбирает аргумент и заводит ветку по принятой схеме: feature/, bugfix/, hotfix/, release/, chore/, experiment/, docs/, test/, refactor/. Перед этим показывает текущую ветку и первые 20 из доступных. Имя без слэша заставит её спросить тип или предложить feature/.

Дальше проверки: есть ли ветка локально или на remote, не длиннее ли имя 50 символов. Существующую локальную берёт обычным git checkout, удалённую создаёт через git checkout -b с origin/, новую — тоже через -b. База зависит от префикса: hotfix/ идёт от main или master, feature/ от develop, если он есть, release/ от develop или main.

Изменения в рабочей директории команда не прячет: при грязном дереве предупредит и предложит stash или commit. Пробелы в аргументе станут дефисами, буквы строчными, лишние символы уйдут. В конце покажет upstream и подскажет /git:push.

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

  • завести ветку feature/ с именем по конвенции проекта
  • переключиться на существующую ветку, не листая git branch -a
  • отвести hotfix/ от main в один вызов
  • подтянуть удалённую ветку локально с трекингом origin/
  • привести кривое имя ветки к git-совместимому виду

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

  • Выполни /git:checkout feature/user-authentication и переключись на новую ветку.
  • Сделай hotfix/security-patch от main.
  • Переключи меня на develop.

Как установить checkout

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

.claude/commands/checkout.md

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

Вопросы о checkout

Как установить checkout в Claude Code?

Положите файл checkout.md из репозитория в .claude/commands/checkout.md внутри проекта. После этого команда вызывается как /git:checkout.

Что делает checkout?

Создаёт или переключает git-ветку по аргументу вида тип/имя. Заодно проверяет, нет ли такой ветки локально или на remote, и выбирает базовую ветку по префиксу.

Что будет при незакоммиченных изменениях?

Команда предупредит о грязной рабочей директории и предложит сделать stash или commit. Сама она изменения не прячет.

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

checkout.md · MIT
---
description: Smart branch creation and switching with conventional naming
allowed-tools: Bash(git:*), Read
category: workflow
argument-hint: "<branch-type/branch-name | branch-name>"
---

# Git Checkout: Smart Branch Management

Create or switch to branches with intelligent naming conventions and setup.

## Current Branch Status

!`git branch --show-current 2>/dev/null || echo "(no branch)"`

## Available Branches

!`git branch -a 2>/dev/null | head -20`

## Branch Creation Task

Based on the arguments provided: `$ARGUMENTS`

Parse the branch specification and create/switch to the appropriate branch.

### Supported Branch Types
- `feature/` - New features and enhancements
- `bugfix/` - Bug fixes (non-critical)
- `hotfix/` - Urgent production fixes
- `release/` - Release preparation branches
- `chore/` - Maintenance and cleanup tasks
- `experiment/` - Experimental features
- `docs/` - Documentation updates
- `test/` - Test-related changes
- `refactor/` - Code refactoring

### Branch Naming Rules
1. If argument contains `/`, use as-is (e.g., `feature/user-auth`)
2. If argument is single word, suggest adding a prefix
3. Convert spaces to hyphens
4. Lowercase all characters
5. Remove special characters except hyphens and slashes
6. Validate branch name is git-compatible

### Workflow

1. **Parse the branch argument**:
   - If empty, show current branch and available branches
   - If contains `/`, treat as type/name format
   - If single word without `/`, ask for branch type or suggest `feature/`

2. **Validate branch name**:
   - Check if branch already exists locally
   - Check if branch exists on remote
   - Ensure name follows git conventions
   - Warn if name is too long (>50 chars)

3. **Create or switch branch**:
   - If branch exists locally: `git checkout <branch>`
   - If branch exists only on remote: `git checkout -b <branch> origin/<branch>`
   - If new branch: `git checkout -b <branch>`

4. **Set up branch configuration**:
   - For hotfix branches: Base off main/master
   - For feature branches: Base off current branch or develop
   - For release branches: Base off develop or main

5. **Report status**:
   - Confirm branch switch/creation
   - Show upstream tracking status
   - Suggest next steps (e.g., "Ready to start working. Use /git:push to set upstream when ready to push.")

### Examples

```bash
# Create feature branch
/git:checkout feature/user-authentication

# Create hotfix from main
/git:checkout hotfix/security-patch

# Switch to existing branch
/git:checkout develop

# Create branch without prefix (will prompt)
/git:checkout payment-integration
```

### Special Handling

For hotfix branches:
- Automatically checkout from main/master first
- Set high priority indicator
- Suggest immediate push after fix

For feature branches:
- Check if develop branch exists, use as base
- Otherwise use current branch as base

For release branches:
- Validate version format if provided (e.g., release/v1.2.0)
- Set up from develop or main

### Error Handling

- If branch name is invalid, suggest corrections
- If checkout fails, show git error and provide guidance
- If working directory is dirty, warn and suggest stashing or committing

© carlrannaberg · MIT · carlrannaberg/claudekit

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

Все слэш-команды по теме «Git и GitHub» →
create-branch getsentry Скилл create-branch для Claude Code создаёт Git-ветки по соглашениям Sentry. Он включается по просьбе создать ветку или при начале работы в ветке по умолчанию. CX Codex +1 4 400установок command-sync-branch softaworks Плагин command-sync-branch для Claude Code синхронизирует feature-ветку с main. Забирает свежие коммиты из основной ветки и применяет их к текущей. ★ 2 707звёзд репо git-workflow agno-team Скилл git-workflow для Claude Code, который помогает следовать best practices в git: форматирует коммиты, предлагает названия веток и структуру PR. Подсказывает формат и чек-листы, не блокируя коммиты. CX Codex +1 675установок jackin-checkout-pr jackin-project Скилл jackin-checkout-pr для Claude Code проверяет рабочее дерево и переключает репозиторий на ветку pull request через gh pr checkout. Выполняет явный checkout PR. CX Codex +1 470установок clean_gone официальный Anthropic Команда clean_gone для Claude Code, которая удаляет локальные git-ветки с меткой [gone] — те, что уже удалены на удалённом репозитории. Заодно убирает связанные воркдеревья, чтобы не оставалось «хвостов». CX Codex +1 ★ 47 914звёзд репо git-worktree-explorer официальный James Montemagno Плагин git-worktree-explorer для GitHub Copilot визуализирует активный Git-репозиторий через worktrees, ветки и коммиты. Показывает структуру репозитория и контекст pull request. ★ 41 430звёзд репо

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

Весь набор →
ignore-init Команда ignore-init создаёт или обновляет .gitignore для файлов Claude Code и временных артефактов разработки. Она пригодится при настройке нового проекта. CX Codex +1 ★ 763звёзд репо push Слэш-команда push для Claude: проверяет ветку, remote и upstream, а потом пушит — сразу, если рабочая копия чистая. CX Codex +1 ★ 763звёзд репо status Команда status анализирует состояние Git-репозитория, группирует изменённые файлы по назначению и даёт подсказки перед коммитом или ребейзом. CX Codex +1 ★ 763звёзд репо cli Проверяет наличие CLI-утилиты и добавляет её справку в CLAUDE.md, чтобы агент видел команды и параметры инструментов проекта. CX Codex +1 ★ 763звёзд репо bash-timeout Команда bash-timeout для Claude Code настраивает таймауты bash-команд в settings.json. Увеличивает лимит для длительных тестов и сборок, превышающих стандартные 2 минуты. CX Codex +1 ★ 763звёзд репо create-command Команда create-command помогает собрать новую слэш-команду Claude Code: уточняет её назначение, готовит файл и показывает, как вызвать результат. CX Codex +1 ★ 763звёзд репо commit Команда commit собирает git-коммит в стиле проекта: проверяет диф, обновляет документацию, пишет сообщение по конвенциям из CLAUDE.md. CX Codex +1 ★ 763звёзд репо code-search Субагент code-search для Claude Code ищет в кодовой базе файлы, функции и шаблоны и возвращает краткий список путей. Локализует код перед правками без лишних рассуждений модели. CX Codex ★ 763звёзд репо

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

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