Cmux State Dashboard — Development skill for Claude Code

---

왜 만들었나

**① 열려 있던 세션이 다 날아갔다.**

2026년 7월 2일, 도구 요청이 아니라 사고 신고에서 시작했다.

**"지금 cmux 워크스페이스와 탭들 열려있는 거 있잖아. 이거 전에 claude code 세션 열려있던 게 다 꺼져버렸는데 그거 복구 가능해?"**

복구는 됐다. cmux가 탭마다 `claude --resume <세션ID>`를 **이미 디스크에 적어 두고 있었기** 때문이다. 어느 탭이 어느 세션이었나의 매핑이 처음부터 파일에 있었다.

**② 그래서 복원했더니, 이번엔 복원이 컴퓨터를 죽였다.**

cmux는 브라우저처럼 **꺼졌던 걸 전부 되살리며 켜진다.** 그런데 이 화면에는 **창 7개 · 워크스페이스 60개 · 탭 100개**가 있었다.

*"이것들이 한 번에 쫙 재부팅되면서 켜지다 보니까 재부팅될 때마다 계속 꺼지는 거예요. (…) **이게 한 세 번 반복됐다가 컴퓨터 망가졌나 했는데**, cmux가 갑자기 계속 팬이 뜨거워지면서 돌아가다가 꺼지는 게 cmux가 열리면서 꺼지는 타이밍이 똑같다 보니까…"*

여기서 이 도구의 진짜 출발점이 나온다.

*"cmux가 워크스페이스와 윈도우, 탭, 그룹 이런 구조를 그대로 복원할 수 있다는 건 **그런 상태들이 계속 저장이 돼 있다는 거겠구나.** 그러면 이거를 **내가 원하는 것만 복원시키는 작업도 가능하겠네.**"*

**전부 되살리는 건 이미 cmux가 한다. 그게 사람을 죽인다. 필요한 건 「고른 것만, 죽이지 않고」였다.**

그 뒤로 도구의 정체는 세 번 더 바뀌었다 — 복붙표 → 레이아웃 복원(7/6) → 상시 관제(8/22) → cmux 제어면(8/26). 전말은 개발사(史)에.

---

이 도구는 두 가지 일을 한다

	무엇	언제 여나
① 되살린다	사고 직전 상태로 돌아가 원하는 것만 복원	강제 종료·재부팅·실수로 닫았을 때
② 찾아 준다	수십 개 탭 중 지금 나를 기다리는 것	하루 종일, 띄워 놓고

만든 사람이 더 중요하게 여기는 쪽은 **①**이다 — *"그것보다 저는 더 중요하게 여기는 게…"* 그래서 여기서도 ①부터 쓴다.

---

① 되살린다 — 복구

스냅샷은 알아서 쌓인다

30초마다 폴링하고 **변화가 있을 때** 스냅샷을 남긴다. 창·워크스페이스·그룹·탭은 물론 **스플릿 분할비율·방향, 브라우저 URL, 워크스페이스 색·고정, claude resume 명령**까지 통째로.

*"macOS 같은 경우에는 대부분 종료시키지 않고 잠자기 모드를 한 다음에 다시 켜서 활동을 하는데, 작업을 너무 오래 지속하다 보면 **일주일, 이주일 되다가 갑자기 강제 종