ccmonitor — Claude Code 세션 실시간 TUI 대시보드

~/.claude/ 데이터 파일을 감시해 Claude Code 세션의 활동을 실시간 ANSI TUI로 표시. Claude Code 코드베이스에 전혀 의존하지 않음.

대시보드 패널

패널	표시 내용
Tools	도구 호출 카운트 (빈도순 정렬)
Subagents	실행 중/완료 에이전트 (타입, 경과시간, 설명)
Skill	활성 스킬, 마지막 완료 스킬, 히스토리
Teams	팀명 + 멤버 목록
Tasks	작업 제목 + 상태 아이콘
File Activity	~/.claude/ 파일 추가/변경/삭제 이벤트

표시 정보

• 세션 ID, 모델명, 경과시간, 유휴시간
• 메시지 수 (User/Assistant)
• 토큰 사용량 (Input/Output/Cache Write/Cache Read)
• 컨텍스트 윈도우 사용률 (Opus 4.5+: 1M, 기타: 200K 기준)

작동 방식 (Claude Code와 완전 분리)

Claude Code 코드를 전혀 임포트하지 않고 두 채널로 데이터 수집:

1. JSONL 트랜스크립트 파싱 — ~/.claude/projects/<dir>/*.jsonl에서 도구 사용, 스킬, 토큰, 모델 추출
2. 디스크 파일 스캔 — subagents 메타데이터, 팀 설정, 태스크 파일, chokidar 파일 감시

스킬 감지 (3중 메커니즘)

1. 슬래시 커맨드 — /skill-name → XML 태그에서 regex 추출
2. Skill 툴 호출 — tool_use 블록에서 name: "Skill" 검출
3. PostToolUse 훅 (옵션) — ~/.claude/.omc/state/last-skill-complete.json에서 즉시 완료 감지

서브에이전트 상태

• 디스크에서 ~/.claude/projects/<dir>/<sessionId>/subagents/agent-*.meta.json 로드
• .jsonl 파일 수정 시간 기반: 30초 이상 미수정 → completed 판정

설치

# 소스에서 직접 실행
git clone https://github.com/tobyilee/ccmonitor.git && cd ccmonitor
bun install && bun run start
 
# 독립 바이너리 (~54MB, Bun 불필요)
bun run build && cp dist/claude-monitor /usr/local/bin/ccmonitor

사용

ccmonitor              # 현재 디렉토리 최신 세션 모니터링
ccmonitor <sessionId>  # 특정 세션 모니터링
# 키보드: r=새로고침, q/Ctrl+C=종료

기술 스펙

• 언어: TypeScript (Bun)
• 런타임: Bun v1.0+ (또는 컴파일된 독립 바이너리)
• 파일 감시: chokidar
• 별: 14★
• 커밋: 5 (2026-04-08~09)

관련 노트

• Claude Code Monitor Tool — 백그라운드 프로세스 모니터링으로 에이전트를 필요할 때만 깨우기

---

Sources

• GitHub: https://github.com/tobyilee/ccmonitor