NoobyGains/claude-pulse

Real-time usage monitor for Claude Code — session limits, weekly limits, and plan tier with colour-coded progress bars

해결하는 문제

Claude Code 사용자는 사용 제한, 비용, 세션 상태에 대한 실시간 가시성을 거의 갖지 못합니다. claude-pulse는 Claude Code 터미널 인터페이스에 직접 통합되는 고도로 사용자 정의 가능한 실시간 상태 표시줄을 제공하여, 워크플로우를 떠나지 않고도 세션 및 주간 제한, 컨텍스트 창 사용량, API 비용을 추적할 수 있습니다.

작동 방식

이 도구는 Claude Code용 플러그인으로 작동하는 단일 파일 Python 스크립트입니다. 상태 갱신 시마다 Claude Code에서 stdin을 통해 전달되는 세션 데이터(모델, 컨텍스트, 비용, 레이트 제한 등)를 읽고, 이를 처리한 후 색상이 적용된 ANSI 상태 줄을 렌더링합니다.

옵션으로 툴 사용량(하트비트)과 Git 브랜치 변경 사항을 실시간으로 추적할 수 있는 훅을 설치할 수 있습니다. 성능을 유지하기 위해 환율과 업데이트 확인에는 로컬 캐시를 사용하며, 사용량 데이터에 대해 직접 API 호출을 하지 않고 stdin 페이로드에서 직접 읽어옵니다.

대상 사용자

Pro 또는 Max 구독을 사용하고 있으며, 리소스 소비 및 세션 메트릭을 시각적으로 실시간으로 확인하고 싶은 개발자.

주요 기능

포괄적인 추적: 세션 및 주간 제한, 모델별 한도(Opus, Sonnet, Fable), 실시간 컨텍스트 창 사용량 모니터링.
의존성 없는 Python: 외부 pip 종속성 없이 단일 파일 설치 가능.
실시간 비용 추적: 25개 이상의 통화로 실시간 환율을 사용해 세션 비용 추적.
심층적인 사용자 정의: 10가지 테마, 5가지 애니메이션 모드, 8가지 다른 바 스타일.
개발자 메트릭: Git 브랜치, 변경된 라인 수, 활성 서브에이전트, 캐시 효율 표시.
통합 도구: 내장된 포커스 타이머와 플러그인 및 Claude Code에 대한 자동 업데이트 알림 포함.

NoobyGains/claude-pulse

해결하는 문제

작동 방식

대상 사용자

주요 기능

관련