satococoa/wtp

어떤 프로젝트인가요?

핵심 기능

• 01브랜치 이름을 바탕으로 worktree 경로를 자동 생성합니다.
• 02`wtp remove --with-branch`로 worktree와 해당 브랜치를 함께 제거합니다.
• 03생성 후 훅으로 파일 복사, 심볼릭 링크 생성, 설정 명령 실행을 수행합니다.
• 04로컬 브랜치가 없으면 원격 브랜치를 자동으로 추적합니다.
• 05Bash, Zsh, Fish의 탭 완성을 지원하는 `wtp cd`를 제공합니다.

활용 사례

• 변경 사항을 stash하지 않고 여러 기능 브랜치에서 동시에 작업할 때.
• 마이크로서비스 또는 모노레포 프로젝트에서 `.env` 파일 복사와 의존성 설치 등으로 새 worktree를 준비할 때.
• 완료된 기능 브랜치와 해당 worktree를 함께 정리할 때.

빠른 시작

1. 1

   Homebrew로 설치(macOS/Linux)

   brew install satococoa/tap/wtp
2. 2

   또는 Go로 설치

   go install github.com/satococoa/wtp/v2/cmd/wtp@latest
3. 3

   새 브랜치로 worktree 만들기

   wtp add -b feature/new-feature

사용 전 알아둘 점

• !Git 2.17 이상이 필요합니다.
• !미리 빌드된 바이너리는 macOS(Apple Silicon)와 Linux용만 제공되며, Intel Mac이나 Windows용은 없습니다.

포함된 컬렉션

토픽

자주 묻는 질문

wtp은(는) 무엇인가요?

브랜치 이름으로 worktree 경로를 자동 생성하고 설정 훅을 실행하며, 브랜치와 함께 worktree를 제거하는 Git worktree CLI입니다. wtp (Worktree Plus)는 여러 브랜치를 나란히 체크아웃해 관리할 때 편리한 기능을 제공하는 git worktree 래퍼 CLI입니다. `wtp add feature/auth`를 실행하면 브랜치 이름에서 경로를 만들어 worktree를 생성하므로, 개발자가 긴 상대 경로를 직접 입력하지 않아도 됩니다. 로컬에만 없는 원격 브랜치도 자동으로 체크아웃할 수 있으며, 브랜치가 여러 원격 저장소에 존재하면 오류를 표시합니다.

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

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

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

활발히 유지보수 중. wtp의 마지막 커밋은 2026년 11월 3일입니다.

wtp은(는) 어디에 사용할 수 있나요?

변경 사항을 stash하지 않고 여러 기능 브랜치에서 동시에 작업할 때. 마이크로서비스 또는 모노레포 프로젝트에서 `.env` 파일 복사와 의존성 설치 등으로 새 worktree를 준비할 때. 완료된 기능 브랜치와 해당 worktree를 함께 정리할 때.

wtp는 어떻게 설치하나요?

Homebrew로 설치(macOS/Linux): brew install satococoa/tap/wtp 또는 Go로 설치: go install github.com/satococoa/wtp/v2/cmd/wtp@latest 새 브랜치로 worktree 만들기: wtp add -b feature/new-feature

wtp은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/satococoa/wtp