
wmux: AI 코딩 에이전트를 위한 워크스페이스 멀티플렉서 (Workspace Multiplexer)
요약
AI 코딩 에이전트의 작업 환경을 효율적으로 관리하기 위한 워크스페이스 멀티플렉서인 wmux를 소개합니다. 터미널, 에이전트, git worktree 등을 통합 관리하며 재부팅 후에도 세션이 유지되는 데몬 기반의 환경을 제공합니다.
핵심 포인트
- 하나의 프롬프트를 여러 에이전트에게 분산하여 최선의 결과를 병합하는 워크플로우 지원
- 에이전트 간 메시징과 작업 위임이 가능한 Slack 스타일의 채널 기능 제공
- 사용자 승인 없이 코드가 실행되는 것을 방지하는 실행 승인 게이트 탑재
- OS 재부팅이나 프로그램 종료 시에도 대화 내용과 워크스페이스 상태 유지
AI 코딩 에이전트와 작업하기 위한 저의 기존 설정은 4개의 터미널 창이었는데, 그중 3개는 제가 무엇을 물어봤는지조차 잊어버린 상태였습니다. 그러다 업데이트를 위해 컴퓨터가 재부팅되었고, 4개의 창이 모두 사라졌습니다. 단순히 창만 사라진 것이 아니라, 그 안의 _대화 내용(conversations)_까지 모두 사라졌습니다.
그래서 저는 wmux를 만들었습니다. MIT 라이선스이며, Windows와 macOS에서 네이티브로 동작합니다.
그것은 무엇인가
tmux는 _터미널 (terminal)_을 멀티플렉싱(multiplexes)합니다. wmux는 터미널, 에이전트 (agents), git worktrees, 브라우저, 그리고 에이전트들이 협업하는 채널(channels)을 포함한 전체 **워크스페이스 (workspace)**를 멀티플렉싱합니다. 이 모든 것은 프로그램 종료, 충돌, 그리고 전체 OS 재부팅 시에도 살아남는 데몬 (daemon)에 의해 관리됩니다.
제 워크플로우를 변화시킨 세 가지
하나의 프롬프트 (prompt) → N개의 에이전트 (agents) → 최선의 결과 병합. 하나의 프롬프트를 최대 8개의 작업으로 분산시키며, 각 작업은 고유한 에이전트 창과 함께 새로운 브랜치의 개별 git worktree에서 수행됩니다. 그런 다음 각 작업의 diff를 나란히 검토하고, hunks를 단일한 '전부 아니면 전무(all-or-nothing)' 방식의 git apply로 채택합니다. 즉, 작업 트리는 완전히 변경되거나 완전히 그대로 유지되며, 중간 단계로 적용되는 일은 없습니다. 클릭 한 번으로 작업을 종료하거나 PR (Pull Request)을 생성할 수 있습니다.
에이전트들이 단순히 공존하는 것이 아니라 협업합니다. 창(pane)을 통해 에이전트 간 메시징과 작업 위임(task delegation)이 이루어지며, 에이전트들이 읽고, 게시하고, @멘션(mention)을 받을 수 있는 Slack 스타일의 **채널 (channels)**이 제공됩니다 (서버 검증된 발신자, 내구성이 있는 수신함, 재부팅 후에도 유지). **실행 승인 게이트 (execute approval gate)**는 원격 에이전트가 사용자의 승인 없이 워크스페이스에서 코드를 실행하는 것을 방지합니다. 이것이 바로 제가 에이전트들이 서로에게 작업을 위임하도록 안심하고 허용할 수 있는 유일한 이유입니다.

대화 내용이 온전하게 유지된 상태로 재부팅 후에도 생존합니다. 데몬 (daemon)이 모든 PTY를 소유합니다. 충돌(crash) 후 다시 열어도 세션과 프로세스 등이 여전히 실행 중이며 — 복구된 에이전트 창(agent panes)을 통해 정확히 이전 대화로 돌아가는 Resume (재개) 기능을 클릭 한 번으로 사용할 수 있습니다. wmux.json에 창(panes)을 선언하면 데몬이 init system처럼 이를 감독합니다.
Zero-config MCP
wmux를 실행하면 Claude Code가 즉시 작동합니다. 84개의 도구(tools)가 호출된 워크스페이스(workspace) 범위 내로 자동 등록됩니다: browser_*, terminal_read/terminal_send, pane_*, channel_*, a2a_*. 또는 CLI를 스크립트로 작성할 수도 있습니다:
wmux send "run the tests" --submit
wmux read-screen --tail 40
wmux channel post backend "tests green, merging"
또한 CDP를 통한 내장 Chrome이 있어, 에이전트가 실제로 클릭하고, 타이핑하고, 스크린샷을 찍을 수 있습니다. React 입력값과 CJK(한중일) 텍스트도 포함됩니다.
사용해 보기
winget install openwong2kim.wmux
macOS (Apple Silicon): .dmg 다운로드 — 서명(signed), 공증(notarized), 스테이플(stapled) 완료됨. Linux 빌드는 실험적(experimental) 단계입니다.
Repo: github.com/openwong2kim/wmux · wmux.app
진심으로 피드백을 받고 싶은 두 가지가 있습니다: 8개의 작업(tasks)이 읽기에 너무 많은 차이점(diffs)인지, 그리고 대부분의 사람들에게는 채널(channels) 방식과 직접 위임(direct delegation) 방식 중 무엇이 더 유리한지입니다. 만약 두 개 이상의 에이전트를 동시에 실행할 때 마치 가축을 몰고 있는 듯한(herding) 느낌이 든다면, 어떤 부분에서 문제가 발생하는지 알려주세요.
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기