LLM Wiki

mux — AI 코딩 세션 라이브 프리뷰 tmux 매니저

4 min read

mux — AI 코딩 세션 라이브 프리뷰 tmux 매니저

여러 moc-claude-code·codex·aider 세션을 동시에 돌릴 때, tmux 세션 이름 대신 실제 출력 프리뷰로 전환 대상을 고르게 해 주는 TUI 도구.

개요

mux는 tmux choose-session의 가장 큰 약점인 “세션 이름만 보고는 현재 상태를 알 수 없다”는 문제를 정면으로 해결한다. 왼쪽에는 세션 목록과 AI CLI 배지, Git 브랜치·워크트리가 표시되고, 오른쪽에는 선택한 세션의 실제 터미널 출력이 500ms 간격으로 갱신되는 라이브 프리뷰가 나온다.

AI 코딩 워크플로우 관점에서는 꽤 실용적이다. 하나의 세션에서 moc-claude-code가 기능 구현 중이고, 다른 세션에서 codex가 리뷰를 돌리며, 또 다른 세션에서 dev server나 테스트가 실행되는 상황이 흔해졌기 때문이다. mux는 이런 멀티 세션 환경을 “세션 전환기”가 아니라 경량 운영 콘솔로 바꾼다.

핵심 기능

  • 라이브 프리뷰: 세션 전환 전에 실제 출력 상태를 확인
  • AI CLI 자동 감지: claude, codex, aider, gemini를 배지로 구분
  • Git 브랜치/워크트리 표시: 어떤 작업 브랜치가 열려 있는지 즉시 파악
  • 팝업 모드: tmux 안에서 오버레이로 열어 현재 작업을 끊지 않고 세션 전환
  • Claude Code 비용/토큰 표시: 세션 로그를 읽어 사용량 추적
  • 상태바 위젯: mux status로 활성 AI 세션 아이콘 노출

왜 중요한가

최근 AI 코딩은 단일 채팅 세션이 아니라 병렬 세션 운영 문제에 가까워지고 있다. 2026-03-29-smux가 tmux-bridge로 에이전트 간 통신을 다뤘다면, mux는 사람이 여러 에이전트 세션을 관찰하고 붙잡아 두는 운영 UI에 가깝다.

이 도구가 보여주는 흐름은 두 가지다.

  • 코딩 에이전트 사용성이 이제 모델 품질뿐 아니라 세션 오케스트레이션 UI까지 포함한다
  • tmux가 단순 터미널 멀티플렉서에서 AI 에이전트 작업대의 런타임으로 재해석되고 있다

사용자가 Tailscale과 함께 원격 접속 중에도 세션 유지와 관찰을 쉽게 하려고 만들었다는 작성자 코멘트도, 에이전트 코딩 환경이 개인 홈랩/원격 개발 운영면으로 확장되고 있음을 잘 보여준다.

설치 메모

README 기준 주요 설치 경로는 다음과 같다.

curl -sSL https://raw.githubusercontent.com/lunemis/mux/main/install.sh | bash
brew install lunemis/tap/mux
go install github.com/lunemis/mux/cmd/mux@latest

팝업 모드는 mux setup-keybind 후 tmux source-file ~/.tmux.conf로 활성화한다.

Sources

그래프 뷰

백링크