max-sixty/worktrunk

Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows

해결하는 문제

Worktrunk는 서로 다른 브랜치를 위한 별도의 작업 디렉토리인 git worktree 관리를 단순화합니다. 이는 개발자가 Claude Code 또는 Codex와 같은 여러 AI 에이전트를 서로의 변경 사항에 간섭 없이 병렬로 실행할 수 있도록 특별히 설계되었으며, 기본 git worktree 명령의 번거로운 수동 오버헤드를 제거합니다.

작동 방식

worktree를 브랜치만큼 쉽게 다룰 수 있는 CLI를 제공합니다. 구성 가능한 템플릿을 사용하여 브랜치 이름을 기반으로 경로를 자동으로 계산하므로, 사용자는 단일 명령으로 worktree를 전환, 생성 및 제거할 수 있습니다. 또한 셸 환경과 통합되어 디렉토리 변경을 자동으로 처리합니다.

대상 사용자

AI 코딩 에이전트를 사용하여 여러 작업을 동시에 처리하는 개발자와, 지속적인 컨텍스트 전환이나 수동 디렉토리 관리 없이 병렬 기능 브랜치를 더 효율적으로 관리하고자 하는 개발자를 위한 도구입니다.

주요 특징

  • 병렬 에이전트 지원: -x 플래그를 사용하여 전환 후 명령을 실행함으로써 별도의 worktree에서 AI 에이전트를 빠르게 시작할 수 있습니다.
  • 워크플로우 자동화: create, pre-merge, post-merge와 같은 작업을 위한 훅(hook)이 포함되어 있습니다.
  • AI 통합: LLM 기반 커밋 메시지 생성 및 AI 생성 브랜치 요약 기능을 제공합니다.
  • 간소화된 병합: squash, rebase 및 worktree 정리를 한 번에 수행할 수 있는 단일 wt merge 명령.
  • 개발자 QoL 향상: 라이브 diff와 함께 worktree를 탐색할 수 있는 대화형 피커, PR 체크아웃 기능, 콜드 스타트를 방지하기 위한 빌드 캐시 공유를 포함합니다.