max-sixty/worktrunk

해결하는 문제

Worktrunk은 서로 다른 브랜치용 별도의 작업 디렉터리인 git worktree의 관리를 간소화합니다. 이는 Claude Code나 Codex와 같은 여러 AI 에이전트를 동시에 실행할 때 특히 유용하며, 에이전트 간에 변경 사항이 서로 간섭되는 것을 방지하면서도, 원시 git worktree 명령어의 불편한 사용자 경험을 제거합니다.

작동 방식

worktree를 브랜치처럼 쉽게 다룰 수 있도록 CLI를 제공합니다. 브랜치 이름을 기반으로 경로를 계산하는 사용자 정의 템플릿을 사용하여, wt switch, wt list, wt merge와 같은 간단한 명령어로 worktree 전환, 새 worktree 생성, 정리 작업을 수행할 수 있습니다. 또한 쉘과 통합되어 명령어 실행 시 자동으로 디렉터리가 변경되도록 지원합니다.

대상 사용자

동일한 리포지토리에서 여러 병렬 작업 스트림을 관리하거나, 여러 AI 에이전트를 동시에 운영해야 하는 개발자 및 AI 에이전트 사용자입니다.

주요 기능

• 간편한 핵심 명령어: 복잡한 git worktree 명령어를 wt switch, wt list, wt merge와 같은 직관적인 작업으로 대체합니다.
• AI 통합: -x 플래그를 통해 worktree 전환 후 바로 에이전트를 시작할 수 있도록 설계되어 있습니다.
• LLM 기반 기능: AI가 생성한 커밋 메시지와 브랜치 요약 기능을 포함합니다.
• 워크플로우 자동화: 의존성 설치 등의 설정 자동화를 위한 훅과, 스쿼시, 리베이스, 정리 작업을 결합한 머지 워크플로우를 지원합니다.
• 효율적인 저장소 사용: 지원되는 파일 시스템(APFS, btrfs, XFS)에서 node_modules 또는 target/ 폴더를 복사-작성(COW) 빌드 캐시를 통해 여러 worktree 간에 공유합니다.
• 인터랙티브 피커: 스트리밍 CI 상태와 차이점 미리보기를 제공하는 시각적 worktree 브라우저입니다.