d-kuro/gwq

해결하는 문제

gwq는 Git worktree 관리를 간소화하도록 설계된 CLI 도구로, 개발자가 단일 저장소에 대해 여러 개의 격리된 작업 디렉토리를 유지할 수 있게 해줍니다. 이를 통해 브랜치를 자주 전환하거나 변경 사항을 스태시(stash)할 필요가 없으며, 병렬 개발, 코드 리뷰, 그리고 여러 AI 코딩 에이전트를 서로 다른 작업에 동시에 실행할 때 특히 유용합니다.

작동 방식

이 도구는 worktree를 생성, 전환, 삭제하기 위한 상위 수준의 인터페이스를 제공합니다. URL 기반 디렉토리 계층 구조(예: ~/worktrees/github.com/user/repo/branch)를 사용하여 디렉토리를 구성하고 이름 충돌을 방지합니다. 내장된 퍼지 파인더(fuzzy finder)를 통해 브랜치와 worktree를 빠르게 선택할 수 있으며, 셸 환경과 통합되어 원활한 디렉토리 변경(cd) 및 탭 자동 완성을 지원합니다.

대상 사용자

여러 기능이나 버그 수정을 동시에 작업하는 개발자, 그리고 병합 충돌 없이 최고 속도로 작업하기 위해 격리된 환경이 필요한 AI 코딩 에이전트 사용자에게 적합합니다.

주요 특징

• 퍼지 파인더 인터페이스: 내장된 퍼지 파인더를 통한 직관적인 브랜치 및 worktree 선택.
• 글로벌 관리: 서로 다른 저장소에 걸쳐 있는 모든 worktree를 한곳에서 액세스하고 모니터링.
• 상태 대시보드: 모든 worktree의 git 상태, 변경 사항 및 활동을 실시간으로 모니터링.
• Tmux 통합: 지속적인 tmux 세션에서 장시간 실행되는 프로세스를 관리할 수 있도록 지원.
• 자동화된 설정: 저장소별 구성을 통해 worktree 생성 시 파일을 자동으로 복사(.env 파일 등)하고 설정 명령(npm install 등)을 실행.
• 셸 통합: Bash, Zsh, Fish, PowerShell과의 깊은 통합을 통해 탭 자동 완성 및 현재 셸 디렉토리 변경 지원.