purplemux / for Claude Code

Claude Code, 여러 작업을 동시에. 더 빠르게.

tmux 기반 멀티 세션 대시보드.
브라우저·모바일·터미널, 끊김 없이 하나의 워크플로우로.

$ npx purplemux
macOS 앱 다운로드
● Node.js 20+ ● tmux 필요 ● macOS / Linux
purplemux 데스크톱 대시보드 purplemux 모바일 화면
왜 purplemux인가

모든 세션을, 하나의 대시보드로.

세션이 늘어날수록 상태를 추적하기 어려워집니다.
purplemux는 모든 세션을 한 화면에 모아 지금 무엇이 진행 중이고 어디서 입력이 필요한지 한눈에 보여줍니다.

레이트 리밋 사이드바
5h 2h 14m 남음 (85%)
7d 4d 9h 남음 (60%)

잔여량을, 실시간으로.

집중하던 순간 한도에 부딪히면 흐름이 끊깁니다. 다음 리셋까지 기다리는 동안 작업은 그대로 멈춥니다.

purplemux는 5시간·7일 잔여량을 사이드바에 상시 표시합니다. 50%·80%에서 색이 바뀌어, 벽에 닿기 전에 페이스를 조절할 수 있습니다.

purplemuxin progress
docs-siteneeds input
landingreview
refactoridle
멀티 세션 대시보드
모든 Claude Code 세션의 작업 중 / 입력 필요 상태를 한눈에.
Refactor auth module
readsrc/lib/auth.ts
editsrc/lib/auth.ts
00:24
라이브 세션 뷰
CLI 로그를 스크롤할 필요 없이 타임라인으로 정리된 진행 상황.
IN PROGRESS3
landing-copy
REVIEW2
fix-auth-bug
tsc-errors
DONE7
세션 상태별 그룹
모든 세션이 Review · In Progress · Done 상태로 자동 분류됩니다.
term diff
web
워크스페이스 저장/복원
tmux 위에서 동작해 브라우저를 닫아도 세션이 유지되고, 패널 레이아웃 · 탭 · 작업 경로까지 묶어 다음날 클릭 한 번으로 복원합니다.
src/lib/auth.ts
12
13
14
15
12
13
14
15
Git Diff 뷰어
터미널 옆 패널에서 diff를 바로 확인. 사이드바이사이드 / 라인별 토글에 구문 강조까지.
~/dev❯docker compose up
~/dev❯vim src/handler.ts
~/dev❯ssh prod.example.com
~/dev❯pnpm dev
진짜 터미널
Claude Code 전용이 아닙니다. xterm.js + node-pty 기반 풀 터미널로 vim · docker · ssh · REPL 무엇이든.
모바일 & 푸시

책상 밖에서도, 그대로.

긴 작업을 지켜보기 위해 자리를 지킬 필요는 없습니다. 모바일 브라우저에서 접속해 홈 화면에 추가하면 네이티브 앱처럼 동작하고, 탭을 닫아도 작업 완료·입력 대기 알림이 Web Push로 도착합니다.

purplemux 모바일 푸시 알림 화면

홈 화면에 추가 (PWA)

브라우저에서 접속 후 홈 화면에 추가하면 풀스크린 앱 아이콘이 생깁니다.

iOS (Safari)
  1. Safari에서 http://<호스트>:8022 접속
  2. 하단 공유 버튼 탭
  3. 목록에서 홈 화면에 추가 선택
  4. 우측 상단 추가 확인
Android (Chrome)
  1. Chrome에서 주소 접속
  2. 우측 상단 ⋮ 메뉴 열기
  3. 앱 설치 또는 홈 화면에 추가 선택

푸시 알림 받기

  1. Settings → Notification → On 으로 활성화 후 브라우저 알림 권한 허용
  2. 백그라운드에서도 Web Push로 전달
  3. 작업 완료 · 입력 필요 시 알림
  4. 알림 탭 시 해당 세션으로 즉시 이동

외부 접근은 Tailscale로

외부 네트워크에서 접근하려면 Tailscale Serve가 가장 깔끔합니다. WireGuard 암호화와 HTTPS 인증서가 자동으로 붙습니다. 

$ tailscale serve --bg 8022

이후 https://<machine>.<tailnet>.ts.net 으로 어디서든 접근. iOS Safari는 HTTPS여야 PWA와 Web Push가 정상 동작합니다.

통계 & 분석

모든 사용량을, 한 화면에서.

오늘 쓴 토큰, 이번 달 비용, 프로젝트별 사용량, 모델별 분포 — 흩어진 숫자를 한 곳에 모아 작업의 리듬과 비용 구조를 한눈에 보여줍니다.

purplemux 사용량 통계 대시보드
01
개요 카드 4종 Sessions · Total · Today · Month
02
일일 활동 추이 최근 30일 세션·메시지 그래프
03
연속 작업 스트릭 Longest · Current · Count · Avg
04
주간 타임라인 요일 × 시간대 스트릭 + 동시 세션
AI 일일 리포트

오늘의 작업을, 자동 요약으로.

하루가 끝나면 세션 로그를 모아 LLM이 한 줄 요약과 상세 요약을 만듭니다. 마크다운으로 저장되어 회고·보고서·1:1 어디에든 그대로 옮길 수 있습니다.

2026-04-13 (Mon) 15 sessions · $5.87
purplemux 랜딩 페이지 초안 작성, 모바일 · PWA 섹션과 통계 대시보드 연결. 공통 카피를 Apple 톤으로 정리하고 feature 카드 목업 전면 교체.
∧ Collapse
purplemux
랜딩 페이지 초안
  • 8개 섹션 구조 설계와 Hero/Why/Mobile/Stats 레이아웃
  • purple 브랜드 컬러 OKLCH 변수화
  • 데스크톱·모바일 스크린샷 목업 프레임 적용
Feature 카드 목업
  • 멀티 세션 대시보드에 실제 spinner/pulse 인디케이터 재현
  • Git Diff · 워크스페이스 · Self-hosted 목업 CSS 세부 조정
  • Tailscale 접근 다이어그램 애니메이션 추가

brief + detailed 이중 요약

한 줄짜리 brief는 대시보드에서, detailed는 클릭 한 번으로 펼쳐서. 마크다운이라 복사해서 회고나 리포트에 그대로 붙일 수 있습니다.

일괄 생성과 재생성

빠진 날짜는 일괄로 한 번에 채우고, 특정 날만 다시 만들고 싶을 땐 그 날만 재생성. LLM이 컨텍스트를 잃지 않게 세션 단위로 묶어서 처리합니다.

어디서든 빠르게

사이드바에 노트 항목으로 상주하고, 단축키 Cmd ⇧ E (macOS) / Ctrl ⇧ E (Linux) 로 바로 열립니다. 로컬에만 저장되므로 외부 전송 걱정 없음.

기능

필요한 기능, 정확히 그만큼.

터미널 7
  • 분할 패널가로 · 세로 분할, 드래그 리사이즈
  • 탭 관리다중 탭, 순서 변경, 프로세스명 자동 제목
  • 단축키분할 · 탭 전환 · 포커스 이동
  • 테마다크 / 라이트 · 색상 세트 다수
  • 워크스페이스패널 · 탭 · 작업경로 저장/복원
  • Git diff 뷰어사이드바이사이드 · 구문 강조
  • 웹 브라우저 패널Electron 내장 미리보기
Claude Code 통합 10
  • 실시간 상태작업 중 / 입력 필요, 즉시 전환
  • 사이드바 세션 모드Workspace ↔ Sessions 전환, 상태별 세션 집합 뷰
  • 라이브 세션 뷰메시지 · 툴콜 · 태스크 · 권한 프롬프트
  • 원클릭 재개중단된 세션을 브라우저에서 바로 이어서
  • 자동 복원서버 재시작 시 이전 세션 복구
  • 퀵 프롬프트자주 쓰는 프롬프트 등록 후 원클릭
  • 메시지 히스토리이전 메시지 재사용
  • 사용량 분석토큰 · 비용 · 프로젝트별 · 일간 리포트
  • 레이트 리밋 카운트다운5시간 / 7일 잔여 · 리셋까지 시간
  • Limit 사용량 경고사이드바 바가 50% · 80%에서 amber · red로 색 변화
모바일 & 접근성 7
  • 반응형 UI폰 · 태블릿에서 터미널 · 타임라인
  • PWA홈 화면 추가 · 네이티브 앱 느낌
  • Web Push탭을 닫아도 알림 수신
  • 멀티 디바이스 동기화워크스페이스 변경 실시간 반영
  • Tailscale외부에서 HTTPS 안전 접근
  • 비밀번호 인증scrypt 해싱
  • 다국어한국어 · English · 日本語 · 中文 · 총 11개
커스터마이즈 9
  • 테마Light / Dark / System 자동
  • 폰트 사이즈Normal · Large · X-Large
  • Custom CSSCSS 변수 오버라이드로 완전 커스텀
  • 터미널 테마라이트/다크 각각 색상 세트 지정
  • 사이드바 재정렬항목 보이기/숨기기 · 드래그 순서
  • Quick Prompts 라이브러리커스텀 프롬프트 추가 · 드래그 정렬
  • 에디터 연동code-server URL로 외부 에디터
  • 알림 제어시스템 알림 on/off
  • Claude 옵션권한 스킵 등 CLI 옵션 토글
구조

브라우저 ↔ Node.js ↔ tmux · Claude Code.

xterm.js는 WebSocket으로 node-pty에 연결되고, node-pty는 전용 purple 소켓의 tmux 세션에 붙습니다. 상태는 Claude Code 훅과 JSONL 로그 워처가 함께 감지합니다.

Browser UI
xterm.js
Terminal
Timeline
events
Status
indicators
Multi‑device
sync
WebSocket
/terminal /timeline /status /sync
Node.js Server :8022
node-pty
Binary PTY ↔ WS
JSONL Watcher
file → parse → send
Status Manager
process tree + JSONL tail
Binary PTY · 이진 stdin/out 훅 + 5–15s 폴링 권한 프롬프트 인터셉트 1MB 백프레셔 · 10 큐
spawn · read
System local
tmux · purple socket
session 1 session 2 …
격리된 purple 소켓 재부팅 후 병렬 복구
Claude Code
~/.claude/sessions/ ~/.claude/projects/{id}.jsonl
공식 Remote Control과의 차이

원격 제어를 넘어, 통합 워크스페이스로.

공식 Remote Control은 Claude Code 세션을 다른 기기에서 이어가는 원격 접속 도구입니다. purplemux는 그 위에 멀티 세션 대시보드, 터미널 확장, 사용량 분석을 얹은 셀프호스팅 운영 환경입니다.

항목 공식 Remote Control purplemux
동시 세션 뷰 목록에서 하나씩 열람 대시보드에 모든 세션 상태 동시 표시
상태 인디케이터 온라인 / 오프라인 Busy · Review · Needs-input · Idle 실시간
푸시 알림 Claude 모바일 앱 설치 필요 Web Push · 설치 없이 어떤 브라우저에서든
터미널 지속성 claude 프로세스 실행 중에만 tmux 기반 · 재시작 후 자동 복구
함께 제공되는 도구 Claude Code 세션 한정 분할 터미널 · Git Diff · 워크스페이스 저장
사용량 분석 — 토큰·비용·프로젝트별 · AI 일일 리포트
강점 Anthropic 공식 · Claude 모바일 앱 통합 · 자동 업데이트 서드파티 OSS · 수동 설치·유지
설치

30초면 끝납니다.

Node.js 20+와 tmux만 있으면 됩니다. 한 줄로 설치하고, 브라우저를 여세요.

1

실행

npx로 바로 시작할 수 있습니다. 전역 설치도 가능합니다.

$ npx purplemux
2

브라우저 열기

기본 포트는 8022입니다. PORT 환경변수로 변경할 수 있습니다.

→ http://localhost:8022
3

원격 접근 (선택)

외부에서 접근하려면 Tailscale Serve를 추천합니다. WireGuard 암호화와 자동 인증서가 딸려 옵니다.

$ tailscale serve --bg 8022
4

네이티브 앱 (선택)

macOS라면 Electron 빌드를 사용할 수 있습니다. Apple Silicon / Intel 모두 지원합니다.

최신 릴리스 다운로드 →
자주 묻는 질문

궁금한 점들.

비용을 줄여주나요?

사용 패턴을 투명하게 보여드립니다. 오늘·이번 달·프로젝트별 비용, 모델별 토큰 분해, 5시간·7일 레이트 리밋 잔여량까지 한 화면에서 확인할 수 있어, 지출 구조를 스스로 조정할 수 있습니다.

권한 프롬프트가 뜨면 모바일에서도 승인할 수 있나요?

가능합니다. Claude Code가 터미널에 띄우는 권한 대화를 purplemux가 감지해 대시보드와 모바일 알림으로 전달합니다. 어디서든 즉시 승인할 수 있어, 작업이 방치되는 일이 없습니다.

시스템이 크래시되면 세션이 날아가나요?

브라우저를 닫거나 네트워크가 끊겨도 tmux가 세션을 유지합니다. 시스템이 완전히 재부팅된 경우에도 purplemux가 워크스페이스 레이아웃을 스캔해 이전 Claude 세션들을 병렬로 복구합니다. 수동 복원 불필요.

데이터는 어디에 저장되나요?

모든 설정과 세션 데이터는 로컬의 ~/.purplemux/ 디렉토리에 저장됩니다. 외부 서버로 전송되는 정보는 없습니다. 인증은 config.json에 scrypt 해시로 보관됩니다.

Windows에서도 쓸 수 있나요?

공식적으로는 지원하지 않습니다. tmux와 node-pty의 플랫폼 제약 때문에 macOS와 Linux만 지원합니다. WSL2 환경이라면 동작할 수 있으나 테스트 범위는 아닙니다.

기존 tmux 세션과 충돌하지 않나요?

purplemux는 전용 purple 소켓에 분리된 tmux 인스턴스를 띄웁니다. 기존 tmux 세션이나 ~/.tmux.conf와 완전히 독립적으로 동작합니다.

외부에서 접속하려면 어떻게 해야 하나요?

Tailscale Serve를 권장합니다. WireGuard 기반 암호화와 자동 HTTPS 인증서를 제공합니다. 직접 리버스 프록시를 쓰실 경우 Nginx / Caddy에서 Upgrade, Connection 헤더를 반드시 포워딩해야 합니다.

비용이 드나요?

purplemux 자체는 MIT 라이선스의 오픈소스이며 무료입니다. Claude Code 사용료는 별도입니다.

모바일에서도 진짜 쓸 만한가요?

네. 반응형 UI와 PWA, Web Push를 기본 제공합니다. 홈 화면에 추가하면 네이티브 앱처럼 동작하고, 탭을 닫아도 작업 완료 · 입력 대기 알림을 받을 수 있습니다.

다국어를 지원하나요?

한국어 · English · 日本語 · 简体中文 · 繁體中文 · Deutsch · Español · Français · Русский · Português (Brasil) · Türkçe 총 11개 언어를 지원합니다.

지금 시작하세요

한 줄이면 됩니다.

Node.js 20+ 와 tmux 만 준비되어 있다면 30초 안에 실행할 수 있습니다.

$ npx purplemux
macOS 앱 다운로드
셀프호스팅 · 오픈소스

내 기기에서만, 내가 소유합니다.

purplemux는 로컬에서 실행되는 셀프호스팅 도구입니다. 세션 데이터·설정·히스토리는 전부 ~/.purplemux/에만 저장되고 외부 서버로 전송되지 않습니다. 전체 소스는 MIT로 공개되어 있어 언제든 읽고·수정하고·기여할 수 있습니다.

MIT License 100% 로컬 0 텔레메트리
~/.purplemux/
├─ config.json
├─ workspaces.json
└─ sessions/
MIT local-only