📌 참고: 이 문서는 awesome Claude Code 문서의 원문 + 레퍼런스입니다.

• 원문 링크를 방문하셔서 복사해서 사용하셔도 됩니다
• 이 파일을 .claude/skills/ 하위에 복사하여 스킬로 등록할 수도 있습니다

(26.03.15 기준)

Git Worktree 커맨드

열린 PR 전체에 대한 Worktree 생성

이 커맨드는 GitHub CLI를 사용하여 열린 풀 리퀘스트를 모두 가져온 다음, 각 PR의 브랜치에 대해 ./tree/<BRANCH_NAME> 디렉토리에 git worktree를 생성합니다.

# GitHub CLI가 설치되어 있고 인증되어 있는지 확인
gh auth status || (echo "Please run 'gh auth login' first" && exit 1)

# tree 디렉토리가 없으면 생성
mkdir -p ./tree

# 열린 PR을 모두 나열하고 각 브랜치에 대해 worktree 생성
gh pr list --json headRefName --jq '.[].headRefName' | while read branch; do
  # 슬래시가 포함된 브랜치 이름 처리 (예: "feature/foo")
  branch_path="./tree/${branch}"

  # 슬래시가 있는 브랜치의 경우, 디렉토리 구조 생성
  if [[ "$branch" == */* ]]; then
    dir_path=$(dirname "$branch_path")
    mkdir -p "$dir_path"
  fi

  # worktree가 이미 존재하는지 확인
  if [ ! -d "$branch_path" ]; then
    echo "Creating worktree for $branch"
    git worktree add "$branch_path" "$branch"
  else
    echo "Worktree for $branch already exists"
  fi
done

# 생성된 모든 worktree 표시
echo "\nWorktree list:"
git worktree list

출력 예시

Creating worktree for fix-bug-123
HEAD is now at a1b2c3d Fix bug 123
Creating worktree for feature/new-feature
HEAD is now at e4f5g6h Add new feature
Worktree for documentation-update already exists

Worktree list:
/path/to/repo                      abc1234 [main]
/path/to/repo/tree/fix-bug-123     a1b2c3d [fix-bug-123]
/path/to/repo/tree/feature/new-feature e4f5g6h [feature/new-feature]
/path/to/repo/tree/documentation-update d5e6f7g [documentation-update]

오래된 Worktree 정리 (선택 사항)

더 이상 존재하지 않는 브랜치의 오래된 worktree를 제거하려면 다음을 추가할 수 있습니다:

# 현재 브랜치 목록 가져오기
current_branches=$(git branch -a | grep -v HEAD | grep -v main | sed 's/^[ *]*//' | sed 's|remotes/origin/||' | sort | uniq)

# 기존 worktree 가져오기 (메인 worktree 제외)
worktree_paths=$(git worktree list | tail -n +2 | awk '{print $1}')

for path in $worktree_paths; do
  # 경로에서 브랜치 이름 추출
  branch_name=$(basename "$path")

  # 특수 케이스 건너뛰기
  if [[ "$branch_name" == "main" ]]; then
    continue
  fi

  # 브랜치가 여전히 존재하는지 확인
  if ! echo "$current_branches" | grep -q "^$branch_name$"; then
    echo "Removing stale worktree for deleted branch: $branch_name"
    git worktree remove --force "$path"
  fi
done

새 브랜치 및 Worktree 생성

이 인터랙티브 커맨드는 새 git 브랜치를 생성하고 해당 브랜치에 대한 worktree를 설정합니다:

#!/bin/bash

# git 저장소 안에 있는지 확인
if ! git rev-parse --is-inside-work-tree > /dev/null 2>&1; then
  echo "Error: Not in a git repository"
  exit 1
fi

# 저장소 루트 가져오기
repo_root=$(git rev-parse --show-toplevel)

# 브랜치 이름 입력 프롬프트
read -p "Enter new branch name: " branch_name

# 브랜치 이름 검증 (기본 검증)
if [[ -z "$branch_name" ]]; then
  echo "Error: Branch name cannot be empty"
  exit 1
fi

if git show-ref --verify --quiet "refs/heads/$branch_name"; then
  echo "Warning: Branch '$branch_name' already exists"
  read -p "Do you want to use the existing branch? (y/n): " use_existing
  if [[ "$use_existing" != "y" ]]; then
    exit 1
  fi
fi

# 브랜치 디렉토리 생성
branch_path="$repo_root/tree/$branch_name"

# 슬래시가 포함된 브랜치 이름 처리 (예: "feature/foo")
if [[ "$branch_name" == */* ]]; then
  dir_path=$(dirname "$branch_path")
  mkdir -p "$dir_path"
fi

# 부모 디렉토리가 존재하는지 확인
mkdir -p "$(dirname "$branch_path")"

# worktree가 이미 존재하는지 확인
if [ -d "$branch_path" ]; then
  echo "Error: Worktree directory already exists: $branch_path"
  exit 1
fi

# 브랜치 및 worktree 생성
if git show-ref --verify --quiet "refs/heads/$branch_name"; then
  # 브랜치가 존재하면, worktree 생성
  echo "Creating worktree for existing branch '$branch_name'..."
  git worktree add "$branch_path" "$branch_name"
else
  # 새 브랜치 및 worktree 생성
  echo "Creating new branch '$branch_name' and worktree..."
  git worktree add -b "$branch_name" "$branch_path"
fi

echo "Success! New worktree created at: $branch_path"
echo "To start working on this branch, run: cd $branch_path"

사용 예시

$ ./create-branch-worktree.sh
Enter new branch name: feature/user-authentication
Creating new branch 'feature/user-authentication' and worktree...
Preparing worktree (creating new branch 'feature/user-authentication')
HEAD is now at abc1234 Previous commit message
Success! New worktree created at: /path/to/repo/tree/feature/user-authentication
To start working on this branch, run: cd /path/to/repo/tree/feature/user-authentication

다른 베이스에서 새 브랜치 생성

현재 HEAD가 아닌 다른 베이스에서 브랜치를 시작하려면, 스크립트를 다음과 같이 수정할 수 있습니다:

read -p "Enter new branch name: " branch_name
read -p "Enter base branch/commit (default: HEAD): " base_commit
base_commit=${base_commit:-HEAD}

# 지정된 베이스를 사용하여 worktree 생성
git worktree add -b "$branch_name" "$branch_path" "$base_commit"

이렇게 하면 새 브랜치의 시작점으로 커밋, 태그 또는 브랜치 이름을 지정할 수 있습니다.