콘텐츠로 이동
Search

Workmux

lastmod 2026-11-16created 2025-12-153 edits

workmux는 git worktree 와 tmux 창을 한 쌍으로 묶어 작업마다 분리된 개발 환경을 만드는 Rust 명령줄 도구이다. 작업 하나에 worktree 하나와 tmux 창 하나를 두므로, 여러 AI 코딩 에이전트를 서로 부딪치지 않게 동시에 돌릴 수 있다. 별도의 TUI·GUI 를 새로 만들지 않고 이미 쓰는 tmux·git·에이전트를 이어 붙이는 쪽을 택했다.

About

  • workmux add<브랜치> 한 번으로 worktree 를 <프로젝트>__worktrees/ 아래 만들고, 파일 복사·심볼릭 링크와 post_create 훅을 실행한 뒤 wm- 접두어가 붙은 tmux 창으로 전환함
  • workmux merge 는 브랜치 병합, worktree 삭제, tmux 창 닫기, 로컬 브랜치 삭제까지 한 번에 처리함. PR 로 병합했으면 workmux remove 로 정리
  • 새 worktree 에는 .env·node_modules 가 없으므로 설정 파일 복사와 의존성 디렉터리 심볼릭 링크를 설정해 둠. 설정은 전역(~/.config/workmux/config.yaml)과 프로젝트(.workmux.yaml) 두 단계
  • --agent 를 여러 번 주거나 --foreach "platform:iOS,Android" 같은 변수 매트릭스로 worktree 여러 개를 한꺼번에 만들고, 프롬프트 템플릿에 변수를 넣어 각각 다른 지시를 줌
  • tmux 창 이름에 에이전트 상태(작업 중·입력 대기·완료)를 아이콘으로 표시함. Claude Code, Codex, OpenCode, Gemini CLI, Copilot CLI 등 지원. 전체 에이전트를 보는 dashboard 와 sidebar 명령도 있음
  • 에이전트를 Docker·Podman·Apple Container 컨테이너나 Lima VM 샌드박스에서 돌려 SSH 키·클라우드 자격 증명에 손대지 못하게 함. SSH 원격 서버 실행, 프롬프트로 브랜치 이름 자동 생성도 지원
  • tmux 가 기본이고 WezTerm·kitty·Zellij·Rex 백엔드는 실험적으로 지원. Git 2.5 이상 필요
  • Homebrew(macOS/Linux), Cargo, mise, Nix 로 설치. MIT 라이선스

See also

Favorite site

author Zer0, MCPBot sitemap