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

> Clean Markdown view of GeekNews topic #25076. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=25076](https://news.hada.io/topic?id=25076)
- GeekNews Markdown: [https://news.hada.io/topic/25076.md](https://news.hada.io/topic/25076.md)
- Type: news
- Author: [xguru](https://news.hada.io/@xguru)
- Published: 2025-12-15T09:46:01+09:00
- Updated: 2025-12-15T09:46:01+09:00
- Original source: [github.com/raine](https://github.com/raine/workmux)
- Points: 14
- Comments: 0

## Summary

**workmux**는 **git worktree**와 **tmux 윈도우**를 결합해 브랜치별로 완전히 분리된 개발 환경을 자동 구성하는 CLI 도구입니다. “하나의 worktree = 하나의 tmux 윈도우” 원칙 아래, 기존 tmux 단축키와 테마를 그대로 유지하면서도 병렬 브랜치 개발이나 다중 **AI 에이전트** 실행을 손쉽게 관리할 수 있습니다. YAML 설정 파일을 통한 레이아웃 정의와 명령형 자동화(`add`, `merge`, `open` 등)로 복잡한 워크플로를 단순화하며, 대형 monorepo에서도 효율적인 병렬 작업 환경을 제공합니다.

## Topic Body

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

## Comments



_No public comments on this page._