amirlehmam/wmux

wmux 는 무엇인가요?

wmux 는 Electron과 xterm.js 기반의 Windows 전용 터미널 멀티플렉서로, Claude Code, Codex, Gemini, Aider 등 AI 기반 코드 어시스턴트(coding agents)의 상태를 쉽게 파악할 수 있도록 도와줍니다. 각 에이전트의 상태(대기 중, 작업 중, 완료, 중단됨)를 사이드바에 표시하고, 에이전트가 실행 중인 패널로 바로 이동할 수 있으며, 스마트폰 브라우저 콘솔에 에이전트의 터미널을 미러링할 수도 있습니다.

AI 지원 개발에 중요한 이유

가시성 – AI 에이전트는 종종 숨겨진 터미널 패널에 대기하고 있습니다. wmux 는 색상 점과 순위 매겨진 목록을 통해 "당신이 필요해"라는 신호를 시각화하여, 어떤 어시스턴트가 차단되었는지 놓치지 않습니다.
로컬, 클라우드 없음 – 모든 감지 및 UI 작업은 로컬에서 수행되며, wmux 는 코드나 화면 데이터를 외부로 전송하지 않습니다.
다중 에이전트 지원 – Claude Code(훅을 통해 상태를 보고) 외에도, API를 제공하지 않는 에이전트(Codex, Gemini, Cursor, Copilot 등)의 상태를, 화면 UI를 내장된 감지 규칙과 매칭하여 추론할 수 있습니다.
스마트폰 친화적 제어 – 127.0.0.1:9790 에서 제공되는 작고 간단한 웹 콘솔을 통해, 어떤 스마트폰 브라우저에서도 프롬프트에 응답하고, 미러링된 터미널을 확인하며, 입력을 전송할 수 있습니다. 책상에서 벗어났을 때 유용합니다.

핵심 기능 (개요)

기능	기능 설명
에이전트 목록 및 탐색기	배너와 `Ctrl+Shift+A/B` 단축키로 가장 오래 대기한 순서로 정렬된 모든 에이전트 목록을 표시하며, 클릭하거나 Enter 키를 누르면 해당 패널로 바로 이동합니다.
화면 기반 감지	내장된 규칙으로 패널의 시각적 출력을 분석하여, 상태를 보고하지 않는 경우에도 차단됨, 작업 중, 대기 중, 침묵 중 으로 레이블링합니다.
패널 cwd에 연결된 파일 탐색기	`Ctrl+Shift+X` 를 눌러 오른쪽 트리 구조를 열 수 있으며, 현재 패널의 작업 디렉터리를 루트로 하여 파일별 변경 수를 표시하고, 인라인으로 파일을 미리보기 또는 편집할 수 있습니다.
스마트폰 웹 콘솔	정렬된 에이전트 목록을 표시하고, 터미널을 미러링하며, 프롬프트 버튼에 탭으로 응답할 수 있습니다. QR 코드를 통한 보안 페어링; 원격 접근을 위한 Tailscale 또는 SSH 터널을 선택적으로 사용 가능합니다.
라이브 브라우저 패널	Claude Code가 웹을 탐색할 때, 그 행동이 내장된 Chromium 패널에 표시됩니다. 링크는 앱 내부 또는 시스템 브라우저에서 열 수 있습니다.
알림 센터	에이전트가 완료되거나 주의가 필요할 때 시각적 벨, Windows 토스트, 작업 표시줄 깜빡임을 제공합니다. OSC 9/99/777 및 CLI `wmux notify` 도 지원합니다.
테마 및 색상 지원	Ghostty/Windows-Terminal 테마 450개 이상을 가져올 수 있으며, CLI를 통해 패널별 색상 스킴을 설정할 수 있습니다.
편집 가능한 코드 보기	마크다운이 아닌 파일은 줄 번호가 있는 에디터로 터미널 옆에 열립니다. 저장은 패널의 폴더에 제한되며, 충돌 감지 기능이 있습니다.
세션 지속성	단일 클릭으로 전체 워크스페이스 레이아웃(분할, 탭, 브라우저, cwd)을 저장하고 복원할 수 있으며, 시작 시 마지막 세션을 자동으로 로드합니다.
스크립터블 JSON-RPC API	이름 붙은 파이프 서버(`\\.\pipe\wmux`)를 통해 외부 도구가 워크스페이스 생성, 패널 분할, 키 입력 전송, 터미널 출력 읽기 등을 수행할 수 있습니다.
GPU 가속 렌더링	WebGL을 사용한 xterm.js로 고속의 부드러운 터미널 출력을 제공합니다.

누구에게 추천되나요?

여러 AI 코드 어시스턴트에 의존하며, 숨겨진 터미널 창을 관리하는 개발자.
각 어시스턴트마다 별도 UI를 갖지 않고도 에이전트 활동을 통합적으로 볼 수 있는 팀.
이미 tmux, Windows Terminal 등의 터미널 멀티플렉서를 사용하고 있으며, 그래픽적이고 AI 인식 가능한 오버레이를 원하는 파워 유저.
책상에서 벗어났을 때 스마트폰으로 에이전트 프롬프트에 응답하고 싶은 사람.

시작하기

다운로드: 릴리스 페이지에서 최신 Windows zip 파일(예: wmux-0.7.10-win-x64.zip)을 다운로드합니다.
압축을 해제하고 wmux.exe 를 실행합니다.
내장된 7단계 튜토리얼을 따라 워크스페이스를 생성하고, 패널을 분할하며, 에이전트(예: Claude Code)를 시작합니다.
설정 → 원격 에서 스마트폰 콘솔을 활성화하고, QR 코드를 스캔하여 기기를 페어링합니다.
Ctrl+Shift+A 를 눌러 에이전트 목록을 확인하거나, 사이드바의 색상 점을 클릭하여 대기 중인 에이전트로 이동합니다.

제한 사항 및 향후 작업 (README에 기재됨)

웹 콘솔 페이지가 닫혔을 때 푸시 알림이 없음.
설치 가능한 PWA, 파일 첨부 지원, 스마트폰에서의 원격 에이전트 시작/정지 기능은 아직 구현되지 않음.
감지 규칙은 일부 에이전트만 커버함. 커뮤니티 기여를 환영합니다.
Claude Code용 오케스트레이터 플러그인은 폐기됨. 기능은 현재 Claude Code 자체에 통합되어 있음.

요약하면: wmux 는 Windows 전용의 Electron 기반 UI 계층으로, 여러 AI 코드 에이전트의 상태를 가시화하고 제어할 수 있게 해주며, 어떤 어시스턴트가 당신의 입력을 기다리는지 파악할 수 있을 뿐만 아니라, 스마트폰에서 응답할 수도 있습니다. 여러 AI 기반 코드 보조 도구를 병렬로 실행하는 개발자에게 특화된 소규모이지만 강력한 도구입니다.