nmux-linux 는 Linux에서 cmux 같은 멀티 프로젝트 작업 화면을 tmux로 만들려는 오픈소스입니다. 문제의식은 분명합니다. AI 코딩 에이전트가 한 프로젝트에서 몇 분씩 작업하는 동안 다른 프로젝트도 봐야 합니다. Linux/tmux 환경에서는 여러 작업을 GUI처럼 관리하기가 쉽지 않습니다.

LinkedIn 원문은 이 배경을 더 현실적으로 설명합니다. 작은 노트북이나 SSH 원격 서버에서는 화면을 넓게 쓰기 어렵습니다. 무거운 GUI 클라이언트도 부담입니다. 원문에는 64GB 메모리 장비에서 cmux가 63GB를 차지한 사례와 터미널 접속만으로 2GB 이하 수준의 멀티 프로젝트 GUI를 쓰고 싶다는 요구가 나옵니다.

화면 구조

README가 설명하는 구조는 세 칸입니다. tmux 한 세션을 프로젝트별 작업 공간으로 바꿉니다. 각 프로젝트는 tmux window 하나로 엽니다.

영역역할원문 기준 기능
왼쪽 sidebar프로젝트 목록과 상태 확인열린 프로젝트, 닫힌 프로젝트, 새 프로젝트 표시
가운데 main coding pane실제 작업 터미널Codex, Claude Code, omx 실행
오른쪽 status/preview pane보조 화면URL 미리보기, 외부 브라우저 열기, 사용자 명령 실행

이 구조가 중요한 이유는 전환 비용입니다. 프로젝트마다 터미널을 따로 찾지 않고 사이드바에서 상태를 보고 넘어갑니다. tmux mouse를 켜면 클릭으로 window 전환, 닫기, 열기까지 처리합니다.

핵심 기능

  1. 프로젝트별 tmux window 는 한 프로젝트를 한 window로 열고 전환합니다. AI 에이전트가 오래 도는 프로젝트를 그대로 두고 다른 프로젝트로 넘어갈 수 있습니다.
  2. 클릭 가능한 사이드바 는 열린 프로젝트와 닫힌 프로젝트를 함께 보여줍니다. 새 프로젝트 진입점도 같은 화면에 둡니다.
  3. 작업 상태 표시 는 실행 중·완료·실패·입력 필요 상태를 사이드바에 붙입니다. 여러 에이전트 작업을 동시에 돌릴 때 가장 먼저 확인할 정보입니다.
  4. 사이드바 깜빡임 완화 는 전체 화면 clear를 줄이고 synchronized output으로 갱신합니다. 상태가 자주 바뀌는 화면에서 읽기 편해집니다.
  5. 오른쪽 preview/webview MVP 는 nmux-linux preview <url>, preview --external <url>, preview --cmd '<cmd>' 로 URL과 명령 실행을 오른쪽 pane에서 처리합니다.
  6. 상태 저장 은 열려 있던 프로젝트 목록을 저장했다가 다음 실행 때 복원합니다. 매번 작업 환경을 다시 여는 수고를 줄입니다.

omx, Claude Code, Codex 연동

README에서 따로 강조하는 부분은 에이전트 도구 연동입니다. omx hud --watch 가 아래 pane을 만들면 clean-omx-hud 와 fix-layout 로 정리합니다. nmux-linux status 는 세션과 pane 상태를 확인합니다. nmux-linux init --force 는 프로젝트 목록을 다시 스캔합니다.

Claude Code hooks는 작업 시작·완료·알림 상태를 사이드바에 반영합니다. Codex와 omx 쪽에서는 HUD pane 생성을 억제하고 stale HUD pane을 정리하는 데 초점을 둡니다. 설치 조건은 Linux와 tmux 3.0 이상, Node.js, bash입니다. 선택 사항은 notify-send, paplay, w3m 계열 브라우저와 xdg-open 입니다.

nmux-linux 는 IDE 대체재라기보다 터미널 기반 멀티 프로젝트 관제 화면에 가깝습니다. 원격 서버에서 여러 Codex/Claude 작업을 돌리고 상태를 보며 프로젝트를 옮겨 다니는 사용자에게 특히 맞습니다.

요약

  • Linux/tmux에서 cmux식 멀티 프로젝트 화면을 가볍게 만들려는 오픈소스입니다.
  • 프로젝트 하나를 tmux window 하나로 열고 sidebar, main pane, preview pane 구조로 관리합니다.
  • 실행 중·완료·실패·입력 필요 상태를 보여줘 여러 AI 에이전트 작업을 한 화면에서 관제합니다.
  • preview 명령과 상태 복원이 핵심입니다. clean-omx-hud 와 fix-layout, Claude Code hooks, Codex/omx 연동도 중요합니다.
  • 원격 서버나 작은 노트북에서 무거운 GUI 대신 터미널 기반 멀티 프로젝트 환경을 원하는 사람에게 맞습니다.