workmux - tmux와 git worktree를 결합한 병렬 개발 워크플로 도구
(github.com/raine)- git worktree와 tmux 윈도우를 통합 관리해, 분리된 개발 환경을 자동 구성하는 워크플로 도구
- 여러 AI 에이전트를 병렬로 실행하거나, 다중 브랜치를 동시에 개발할 때 충돌 없이 관리 가능
- tmux 네이티브 통합 구조로, 별도 TUI나 GUI 없이 tmux 자체를 인터페이스로 사용하여 기존 단축키·테마·작업 흐름을 그대로 유지
- “하나의 worktree = 하나의 tmux 윈도우” 원칙으로, 각 브랜치별 독립 환경 제공
-
명령형 자동화 중심 설계로, 복잡한 단계 없이
add,merge,open등 몇개의 명령으로 전체 워크플로 처리-
add: 새 worktree 및 tmux 윈도우 생성 -
merge: 브랜치 병합 및 정리 -
remove: 병합 없이 worktree 제거 -
list: 전체 worktree 목록 표시 -
open: 기존 worktree 재개 -
path: worktree 경로 출력 -
claude prune: 삭제된 worktree 관련 Claude 설정 정리 -
completions: 쉘 자동완성 스크립트 생성
-
-
YAML 기반 설정 파일(
.workmux.yaml) 로 tmux 레이아웃, 파일 복사·심볼릭 링크, 후처리 명령 정의 -
Git worktree의 장점을 극대화
- 브랜치 간 무충돌 병렬 개발
- 컨텍스트 전환 최소화로 생산성 향상
- 각 브랜치별 독립 빌드·의존성 환경 유지
-
다중 worktree 생성 모드 지원
- 여러 에이전트(
--agent) 또는 변수 매트릭스(--foreach) 기반 병렬 작업 환경 생성 - 프롬프트 템플릿을 통해 각 인스턴스별 맞춤 작업 지시 가능
- 여러 에이전트(
-
패키지 매니저·빌드 디렉터리 고려사항을 자동 처리
-
node_modules,target등 공용 디렉터리 symlink 지원 - 대형 monorepo의 삭제 지연 문제를 백그라운드 정리 스크립트로 해결
-
- AI 에이전트 상태 표시 기능으로 tmux 창 이름에 Claude Code 진행 상태(작업 중·대기·완료) 표시
- 글로벌/프로젝트별 설정 계층 구조로, 공통 설정과 프로젝트별 오버라이드 분리 관리
- Rust 기반 CLI로 제작되어 macOS·Linux 환경에서 Homebrew 또는 Cargo로 설치 가능
GeekNews Weekly에 포함된 글입니다.
에디터 코멘트 보기