Skip to content

Workmux

tmux와 git worktree를 결합한 병렬 개발 워크플로 도구

About

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

See also

Favorite site