sessmon

Claude Code 세션을 실시간 모니터링하고, 히스토리와 통계를 제공하는 CLI + 대시보드.

설치

npm install -g sessmon

시작하기

# 1. 전역 훅 등록 (한 번만)
sessmon init --global

# 2. 서버 시작
sessmon serve

# 3. 대시보드 열기
open http://localhost:3456

이후 평소처럼 Claude Code를 사용하면 자동으로 데이터가 수집됩니다.

CLI 명령어

sessmon                    # 인터랙티브 터미널
sessmon init --global      # 전역 훅 등록
sessmon init               # 현재 프로젝트에만 훅 등록
sessmon serve              # 서버 시작 (포그라운드)
sessmon serve --daemon     # 백그라운드 데몬
sessmon serve --stop       # 데몬 중지
sessmon serve --port 4000  # 포트 변경
sessmon status             # 활성 세션 확인
sessmon history            # 세션 히스토리
sessmon history --export json
sessmon history --export csv
sessmon config                 # 알림 설정 확인
sessmon config notify_method toast   # 알림 방식 변경 (toast/system)
sessmon config notify_session_stopped false  # 개별 알림 끄기

기능

• 실시간 모니터링 — 세션 상태, 도구 사용 라이브 피드, WebSocket 실시간 업데이트
• 세션 상태 추적 — Active(작업 중), Idle(턴 완료), Waiting(서브에이전트 대기), Completed
• 서브에이전트 추적 — 멀티에이전트 스폰/종료 추적
• 히스토리 & 통계 — 검색/필터, 활동 히트맵, 도구 사용 분포
• Git 변경 추적 — 세션별 커밋 매핑, 변경량 기록
• 트랜스크립트 — 대화 내역 자동 백업 및 열람
• 이상 감지 — 에이전트 멈춤 의심, 루프 감지
• 알림 시스템 — 작업 완료, 입력 대기, 루프/멈춤 감지 알림
  • Dashboard Toast 또는 시스템 알림 선택 가능
  • 알림 종류별 개별 on/off (CLI sessmon config 또는 대시보드 설정)
• 다크/라이트 테마 — Adobe Premiere 스타일 다크 + Claude 스타일 라이트

동작 원리

Claude Code의 HTTP 훅을 사용합니다. init으로 훅을 등록하면 Claude Code가 도구를 사용할 때마다 POST /events로 이벤트를 전송합니다. 서버가 꺼져 있어도 Claude Code 동작에는 영향이 없습니다.

데이터 저장

모든 데이터는 ~/.claude-khala/에 저장됩니다.

~/.claude-khala/
├── khala.db          # SQLite 데이터베이스
├── transcripts/      # 트랜스크립트 백업
├── server.pid        # 데몬 PID
└── server.log        # 데몬 로그

기술 스택

Fastify · better-sqlite3 · WebSocket · React · Vite · Tailwind CSS · Zustand · Recharts · simple-git · Commander.js

라이선스

MIT