-
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로 설치 가능