Git 워크트리 관리를 간소화하는 CLI 도구 Worktrunk
max-sixty/worktrunk
GitHubWorktrunk는 Git worktree 관리를 위한 CLI 도구로, 여러 개의 독립적인 작업 환경을 마치 브랜치처럼 쉽고 직관적으로 관리할 수 있게 돕습니다.
- 기존의 복잡했던 `git worktree` 사용법을 개선하여, 작업 환경 전환(switch), 목록 확인(list) 등 핵심 명령어를 단순화하고 AI 에이전트 병렬 작업을 지원합니다.
- 여러 개발 환경을 동시에 관리하거나 AI 기반 워크플로우를 사용하는 사용자에게 필수적이며, PR 체크아웃이나 CI 상태 확인 같은 고급 기능도 제공합니다.
- Homebrew, Cargo 등 다양한 방식으로 설치가 가능하며, 커스텀 훅(hooks)이나 별칭 설정을 통해 복잡한 개발 워크플로우를 세밀하게 자동화할 수 있습니다.
Worktrunk는 Git worktree 관리를 위한 CLI 도구로, 여러 개의 독립적인 작업 환경을 마치 브랜치처럼 쉽고 직관적으로 관리하도록 설계되었습니다. 특히 Claude Code나 Codex 같은 가 5~10개 이상 병렬 작업을 수행할 때, 각 에이전트에게 전용 작업 디렉토리를 제공하여 변경 사항 간 충돌 없이 작업을 진행할 수 있도록 합니다. 기존의 Git worktree 사용 경험은 복잡하며, 새로운 worktree를 시작하는 것조차 브랜치 이름을 세 번 입력해야 하는 등 불편함이 있었습니다.
Worktrunk는 핵심 명령어를 통해 작업 환경 관리를 대폭 간소화합니다. 예를 들어, worktree 전환은 `wt switch feat`와 같이 간단하게 처리할 수 있으며, 기존의 복잡한 `cd ../repo.feat` 명령어보다 직관적입니다. 또한, 새로운 작업을 시작하고 에이전트를 실행하는 과정도 `wt switch -c -x claude feat`라는 단일 명령어로 처리 가능하여 작업 흐름을 크게 개선합니다. 정리(Clean up) 역시 `wt remove`로 간편하게 처리할 수 있습니다.
단순한 환경 관리를 넘어, Worktrunk는 다양한 고급 워크플로우 자동화를 지원합니다. Hooks를 통해 생성, 병합 전, 병합 후 등의 명령어 실행을 자동화할 수 있으며, 기반 커밋 메시지 생성이나 PR 체크아웃(`wt switch pr:123`) 같은 기능도 제공됩니다. 또한, 여러 개의 에이전트를 동시에 관리할 때 `wt switch -x claude -c feature-a -- '...'`와 같이 간단한 명령어로 병렬 작업을 실행하는 것이 가능합니다.
용어 풀이
- AI 에이전트
- 목표를 받으면 스스로 계획을 세우고 도구를 써서 여러 단계의 작업을 해내는 AI.
- LLM
- 방대한 글을 학습해 문장을 이해하고 만들어 내는 AI 모델. ChatGPT, Claude, Gemini가 여기에 속해요.