k1LoW/git-wt

어떤 프로젝트인가요?

핵심 기능

• 01`git wt <branch>` 명령 하나로 worktree와 브랜치를 전환하거나 생성합니다.
• 02커밋되지 않은 작업이나 병합되지 않은 브랜치가 있으면 삭제하지 않는 안전 삭제 기능과 강제 삭제 옵션을 제공합니다.
• 03worktree 디렉터리와 브랜치 이름을 함께 변경합니다.
• 04새 worktree에 무시된 파일, 추적되지 않은 파일 또는 수정된 파일을 복사하거나 심볼릭 링크로 연결합니다.
• 05생성 후 또는 삭제 전에 훅을 실행합니다.
• 06자동 완성을 지원하는 zsh, bash, fish, PowerShell 셸 통합 기능을 제공합니다.

활용 사례

• 한 번의 checkout에서 브랜치를 숨겨두거나 전환하지 않고 여러 브랜치에서 동시에 작업할 때.
• 현재 작업은 그대로 둔 채 별도의 디렉터리에서 pull request를 검토할 때.
• 심볼릭 링크로 대용량 의존성 디렉터리를 worktree 간에 공유해 디스크 공간과 설정 시간을 절약할 때.
• fzf, peco 또는 tmux와 연동해 대화형으로 worktree를 선택하고 전환할 때.

빠른 시작

1. 1

   Go로 설치

   go install github.com/k1LoW/git-wt@latest
2. 2

   또는 Homebrew로 설치

   brew install k1LoW/tap/git-wt
3. 3

   저장소의 worktree 목록 보기

   git wt
4. 4

   브랜치용 worktree로 전환하거나 생성

   git wt feature-branch

사용 전 알아둘 점

• !디렉터리를 자동으로 전환하는 셸 통합 기능은 bash, fish, PowerShell에서 실험적 기능으로 표시되어 있습니다.

포함된 컬렉션

토픽

자주 묻는 질문

git-wt은(는) 무엇인가요?

브랜치나 디렉터리 이름으로 worktree를 전환·생성·삭제·이름 변경할 수 있는 Git 하위 명령어입니다. git-wt는 `git worktree`를 더 간결한 인터페이스로 사용할 수 있게 해주는 Git 하위 명령어입니다. `git wt <branch>`를 실행하면 기존 worktree로 전환하거나, 브랜치가 아직 없을 경우 브랜치와 함께 새 worktree를 만듭니다. worktree 목록을 확인하고(JSON 출력 옵션 포함), 삭제하거나 디렉터리와 브랜치 이름을 함께 변경할 수도 있습니다.

git-wt은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

git-wt은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

git-wt은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. git-wt의 마지막 커밋은 2026년 10월 15일입니다.

git-wt은(는) 어디에 사용할 수 있나요?

한 번의 checkout에서 브랜치를 숨겨두거나 전환하지 않고 여러 브랜치에서 동시에 작업할 때. 현재 작업은 그대로 둔 채 별도의 디렉터리에서 pull request를 검토할 때. 심볼릭 링크로 대용량 의존성 디렉터리를 worktree 간에 공유해 디스크 공간과 설정 시간을 절약할 때. fzf, peco 또는 tmux와 연동해 대화형으로 worktree를 선택하고 전환할 때.

git-wt는 어떻게 설치하나요?

Go로 설치: go install github.com/k1LoW/git-wt@latest 또는 Homebrew로 설치: brew install k1LoW/tap/git-wt 저장소의 worktree 목록 보기: git wt 브랜치용 worktree로 전환하거나 생성: git wt feature-branch

git-wt은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/k1LoW/git-wt