wmux – AI 에이전트를 위한 ADE(Agent Development Environment)

개요

wmux는 tmux 스타일의 팬 레이아웃에서 여러 AI 에이전트 명령줄 도구(Claude Code, Codex, Gemini 등)를 나란히 실행할 수 있는 데스크톱 애플리케이션(Windows/macOS)입니다. 백그라운드 데몬이 UI를 닫거나 재부팅해도 모든 팬을 유지하며, iPhone 앱을 통해 에이전트의 대화형 프롬프트에 응답할 수 있습니다.

핵심 아이디어

아이디어	wmux 구현
모든 CLI 기반 AI 에이전트 실행	각 에이전트는 자체 PTY(Windows에서는 ConPTY, macOS에서는 forkpty)에서 실행됩니다. Windows에서 WSL이 필요 없습니다.
세션 지속성	데몬이 PTY를 소유합니다. UI를 닫거나 충돌해도 프로세스는 계속 실행되며, 재시작 시 팬은 정확한 대화를 재개할 수 있습니다.
휴대폰 기반 승인	iPhone 클라이언트가 데몬과 페어링합니다(Tailscale을 통한 HTTPS). 에이전트가 질문(예: Claude Code 권한)을 하면 프롬프트가 휴대폰의 받은 편지함에 표시되고, 답변이 팬으로 다시 전송됩니다.
Git worktree로 팬아웃	하나의 프롬프트를 최대 8개의 독립적인 작업으로 분할할 수 있습니다. 각 작업은 `wtask/*` 브랜치에 자체 Git worktree와 자체 팬을 가지며, 단일 커밋으로 적용하기 전에 차이점을 헝크 단위로 검토할 수 있습니다.
내장 브라우저 자동화	에이전트는 Chrome DevTools Protocol을 통해 내장 브라우저 팬 또는 실제 Chrome 인스턴스를 제어할 수 있습니다. 기록된 흐름은 재생할 수 있습니다.
Fleet 보기	전역 주의 목록(`⌘⇧A` / `Ctrl+Shift+A`)은 워크스페이스 전반의 모든 에이전트를 당신이 필요함, 검토 준비됨, 실행 중, 유휴로 그룹화하여 표시합니다.
Git 통합	사이드 레일에 이슈/PR이 표시되며, 열기, 댓글, CI 재실행, 항목을 팬에 끌어다 놓아 에이전트에 전달할 수 있습니다.

주요 기능(빠른 개요)

크로스 플랫폼: 네이티브 Windows 10/11 및 macOS Apple 실리콘 빌드(실험적 Linux AppImage/.deb/.rpm).
iPhone 동반 앱 – 질문에 답하고, 받은 편지함을 확인하고, 선택적 푸시 알림(봉인된 봉투).
Worktree 팬아웃 – 병렬 작업을 위한 Git worktree 자동 생성 및 시각적 diff 검토 UI.
브라우저 팬 – 내장 터미널 기반 브라우저 또는 에이전트별 전용 Chrome 탭. 흐름 기록/재생.
에이전트 간 메시징 – 팬은 서로 메시지를 보낼 수 있습니다(send_message).
사용량 제한 처리 – 할당량이 소진되면 에이전트가 일시 중지됩니다. 선택적 재설정 시 재개로 자동 재시작됩니다.
데몬 관리 세션 – 종료, 충돌, 재부팅 후에도 유지됩니다. 팬은 감독되고 자동 재시작될 수 있습니다.
원격 읽기 전용 보기 – wmux web은 브라우저에 실시간 팬을 제공합니다(기본적으로 루프백만).
확장 가능한 CLI 및 API – wmux CLI를 스크립트하거나 토큰 인증 소켓을 통해 연결하여 이벤트에 반응할 수 있습니다.
키보드 중심 UI – tmux 스타일 분할, 워크스페이스, 명령 팔레트, 완전히 구성 가능한 단축키.

사용 대상

개발자: 코드 생성 에이전트(Claude Code, Codex, Gemini)에 의존하고 안정적인 다중 팬 워크스페이스를 원하는 개발자.
팀: 재부팅 후에도 장기 실행 에이전트 세션을 유지하고 휴대폰에서 작업을 승인해야 하는 팀.
연구자: 다중 에이전트 파이프라인을 실험하고 프롬프트를 병렬 Git worktree로 팬아웃하는 방법이 필요한 연구자.
파워 유저: 터미널 멀티플렉서를 좋아하지만 내장 브라우저 자동화와 GitHub 통합도 원하는 사용자.

시작하기

설치 – winget install openwong2kim.wmux(Windows) 또는 서명된 .dmg 다운로드(macOS).
실행 – UI가 시작되고 백그라운드에서 데몬이 시작됩니다.
에이전트 추가 – 선택기에서 CLI 에이전트(Claude Code, Codex, Gemini 등)를 선택하면 팬이 열립니다.
iPhone 페어링 – Remote → Share & pair를 열고 Tailscale에서 HTTPS를 활성화하고 iOS 앱으로 QR 코드를 스캔합니다.
작업 생성 – 프롬프트를 입력하고 Fan-out을 선택(최대 8개의 worktree)한 다음 차이점을 검토하고 적용합니다.

소스에서 빌드(기여자용)

git clone https://github.com/openwong2kim/wmux.git
cd wmux
npm install          # Node 18+, Python 3, 네이티브 도구 체인
npm start            # 개발 모드
npm run make         # 설치 프로그램 패키지

프로젝트는 Electron, xterm.js, node-pty, Playwright를 테스트에 사용합니다.

라이선스 및 안전

MIT 라이선스 – 자유롭게 사용 및 수정할 수 있습니다.
데몬은 설치한 에이전트 CLI만 실행합니다. 각 제공업체의 서비스 약관을 준수하는 것은 사용자의 책임입니다.
휴대폰과 데몬 간 통신은 토큰 인증 및 암호화로 보호되며, 푸시 알림은 릴레이가 내용을 읽을 수 없도록 봉인됩니다.

wmux는 AI 에이전트 오케스트레이션에 초점을 맞춘 진정한 소프트웨어 프로젝트로, AI 에이전트 개발 환경 분야에 완전히 부합합니다.

openwong2kim/wmux