tmux 처럼 하나의 터미널을 여러 패널·탭으로 나눠 쓰되, 마우스·메뉴를 1급으로 지원합니다. 앱을 닫아도 셸은 살아 있고, Claude Code 토큰 사용량을 한눈에 보여주고 리밋에 걸리면 자동으로 재개합니다. macOS · Linux · Windows 네이티브.
명령어를 다 외우지 못해도, 마우스를 더 쓰고 싶어도 괜찮습니다. 세 가지 방식 모두로 제어합니다.
경계선 드래그로 패널 크기 조절, 클릭으로 포커스, 우클릭으로 메뉴, 휠로 스크롤백. Shift+드래그로 두 패널을 맞바꿉니다.
단축키를 외우지 않아도 메뉴(prefix Enter)와 명령 프롬프트(prefix :)로 거의 모든 동작을 합니다.
셸 PTY 를 백그라운드 데몬이 보유합니다. 앱을 닫거나 터미널 창을 닫아도 셸은 계속 돌고, 다시 실행하면 그대로 이어 붙습니다.
tmux 와 달리 WSL·Cygwin 없이 윈도우에서 그대로 동작합니다. ConPTY 기반 pty-host 로 PowerShell·cmd 를 띄우고, macOS·Linux 와 같은 경험을 줍니다.
탭 → 윈도우 → 패널 계층. 최상위는 탭이고, 각 탭을 패널 집합으로 분할합니다.
한 화면을 좌우·상하로 자유롭게 분할하고 중첩합니다. 패널이 둘 이상이면 각 패널을 테두리로 감싸고, 활성 패널은 파란색으로 강조합니다.
탭이 하나여도 상단에 탭 인터페이스가 나타나고, 마지막 탭 오른쪽의 [+] 로 새 탭을 엽니다. 탭은 1번부터 번호가 매겨지고 드래그로 재정렬합니다.
우클릭 또는 prefix Enter 로 패널·레이아웃·탭 그룹으로 정리된 메뉴를 엽니다. prefix : 명령 프롬프트는 공백 검색·자동완성·인자 이력을 지원합니다.
copy-mode 로 따로 들어가지 않아도, 패널 위에서 휠을 올리면 바로 지난 출력을 봅니다. 패널마다 독립적입니다.
패널에서 돌리는 Claude Code 의 상태·토큰·한도를 상태줄과 팝업으로 한눈에.
실행 중인 탭에 상태 아이콘(대기 ○ / 처리중 ◐ / 리밋 멈춤 ⊘)을 표시하고, 비활성 탭 작업이 끝나면 탭 배경색으로 알립니다. 사용량 리밋에 걸려 멈추면 해제 시각을 읽어 그때 자동으로 재개합니다.
상태줄의 토큰 배지를 클릭하면 기간 / 세션 / 한도 / 경고 / /usage / 시나리오 노트북 탭으로 보는 사용량 팝업이 열립니다. 화면 스크랩이 아닌 ~/.claude/*.jsonl 트랜스크립트 회계로 cache_read 까지 정확히 집계합니다.
진짜 claude CLI 를 패널에서 돌리며 모델 배지, 프롬프트 이력 미리보기·점프, 컨텍스트 하드스톱 자동 복구까지 그대로 동작합니다.
실행 중인 셸을 살린 채 코드를 교체하고, ssh 너머의 다른 pytmux 서버에 붙습니다.
restart-server · restart-all · restart-check(드라이런)로, 열린 패널의 셸 · 실행 중 프로그램 · 스크롤백을 살린 채 코드만 새 이미지로 교체합니다(제자리 re-exec). Windows 는 아웃오브프로세스 pty-host 로 세션을 유지합니다.
remote-attach 로 ssh 너머 다른 머신의 pytmux 서버에 붙습니다. 원격 탭은 탭바·외곽선을 분홍색으로 구분하고, 원격 서버가 없으면 분리 서버를 자동 기동합니다.
클라↔서버 IPC 지연이 커지면 패널 외곽선을 빨간색으로 표시하고, 고착되면 reconnect(또는 워치독 자동)으로 실행 중 셸 / Claude 를 죽이지 않고 IPC 만 다시 세워 반응성을 회복합니다.
시계·달력·디렉토리 트리·IME 배지·Claude 통합·토큰 화면이 모두 한 디렉토리로 응집된 플러그인입니다.
소스는 GitHub 에 공개되어 있습니다. 클론하거나 zip 으로 받아 바로 실행하세요.
main 브랜치 스냅샷
main.zip ↗
git 으로 클론해서 바로 실행 — 아래 명령만 복사하면 됩니다.
파이썬만 있으면 됩니다. Python 3.11 이상 권장.
① 의존성 설치 (Textual · pyte · wcwidth). Windows 는 pip install pywinpty 도 추가합니다.
② 실행 — 서버가 없으면 자동 기동 후 attach 합니다.
③ pytmux 명령으로 등록(선택). 등록하면 어디서든 호출할 수 있습니다. OS 에 맞는 설치 스크립트를 실행하세요.
macOS · Linux
Windows (PowerShell)
pytmux 는 attach(없으면 기동), pytmux ls 는 탭/패널 요약, pytmux cmd new-tab 은 외부에서 서버를 제어합니다.
버그 제보·제안·문의는 GitHub 이슈 또는 메일로 보내 주세요.