JayantDevkar/claude-code-karma

해결하는 문제

Claude Code는 세션 데이터, 도구 호출, 토큰 사용량을 인간이 읽기 어려운 로컬 JSONL 파일에 저장하며, 30일 후 자동 삭제됩니다. Claude Code Karma는 이 원시 데이터를 검색 가능하고 분석 가능한 이야기로 변환하는 로컬 우선 시각화 대시보드를 제공합니다.

작동 방식

이 도구는 사용자의 머신에 있는 ~/.claude/ 디렉터리에서 데이터를 직접 읽습니다. FastAPI 백엔드가 이 파일들을 분석하고 메타데이터를 로컬 SQLite 데이터베이스에 인덱싱한 후, SvelteKit 프론트엔드로 시각화합니다. 또한 Claude Code 훅과 통합하여 활성 세션의 실시간 모니터링도 가능합니다.

대상 사용자

Claude Code CLI 또는 Claude Desktop(Claude Code 모드)를 사용하여 비용을 추적하고, 도구 사용량을 분석하며, AI 보조 개발의 시각적 기록을 유지하고자 하는 개발자들입니다.

주요 기능

• 세션 분석: 세션별 또는 프로젝트 전체에 대한 토큰 사용량, 비용, 캐시 히트율, 도구 분포의 세부 분석.
• 실시간 추적: 실시간 세션 상태 모니터링 및 특정 터미널 창을 한 번의 클릭으로 열 수 있는 기능.
• 심층 분석: 작업, 파일 작업, 서브에이전트 활동, 호출된 기술을 추적하는 전용 탭.
• 티켓 연동: MCP 서버 또는 브랜치 이름 자동 감지를 통해 Linear, Jira, GitHub Issues와 세션을 연결 가능.
• 로컬 우선: 클라우드 계정이나 텔레메트리 없이 모든 데이터는 사용자 기계에만 보관됩니다.