Git 워크트리 관리를 간소화하는 CLI 도구 Worktrunk — AI 생성 일러스트
개발도구 도구

Git 워크트리 관리를 간소화하는 CLI 도구 Worktrunk

max-sixty/worktrunk

GitHub9월 12일 발표 · 3분

Worktrunk는 Git worktree 관리를 위한 CLI 도구로, 여러 개의 독립적인 작업 환경을 마치 브랜치처럼 쉽고 직관적으로 관리할 수 있게 돕습니다.

세 줄 요약GitHub 원문 기반
  1. 기존의 복잡했던 `git worktree` 사용법을 개선하여, 작업 환경 전환(switch), 목록 확인(list) 등 핵심 명령어를 단순화하고 AI 에이전트 병렬 작업을 지원합니다.
  2. 여러 개발 환경을 동시에 관리하거나 AI 기반 워크플로우를 사용하는 사용자에게 필수적이며, PR 체크아웃이나 CI 상태 확인 같은 고급 기능도 제공합니다.
  3. 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가 여기에 속해요.
원문GitHub · max-sixty/worktrunk
원문 보기GitHub