rz1989s/claude-code-statusline

해결하는 문제

Claude Code Enhanced Statusline은 Claude Code를 사용할 때 터미널 하단에 실시간 정보를 표시할 수 있는 매우 사용자 정의 가능한 상태줄을 제공합니다. 토큰 비용, 모델 버전, git 상태, MCP 서버 건강 상태 등의 다양한 메트릭을 수동으로 확인해야 하는 번거로움을 해결하기 위해, 이 정보들을 사용자가 설정 가능한 상태줄(여러 줄 가능)로 통합합니다.

작동 방식

이 프로젝트는 여러 개의 쉘 스크립트와 TOML 설정 파일로 구성되어 있습니다. 모듈식 아키텍처를 사용하며, 각각의 '원자적 컴포넌트'(예: cost_daily.sh 또는 mcp_status.sh)는 특정 데이터를 수집하고 렌더링합니다. 메인 오케스트레이터는 Config.toml 파일에 따라 모듈을 로드하며, 사용자는 표시할 줄 수(1~9줄)와 각 줄에 표시할 컴포넌트를 정의할 수 있습니다.

대상 사용자

터미널 워크플로우를 떠나지 않고도 세션 비용, 자원 사용량, 환경 상태를 더 깊이 파악하고 싶은 Claude Code 사용자.

주요 특징

• 원자적 컴포넌트 시스템: 28개의 단일 목적 컴포넌트로 정밀한 표시 제어 가능 (예: 일일, 주간, 월간 비용용 별도 컴포넌트)
• 블록 메트릭: 내장된 비용 계산, 소모 속도 모니터링, 캐시 효율 추적, 비용 예측 기능
• 모듈식 레이아웃: 1~9줄까지 사용자 정의 가능한 표시로, 컴포넌트를 원하는 순서로 조합 가능
• 풍부한 통합 기능: git 상태, Claude Code 버전 관리, MCP 서버 건강 상태 외에도 이슬람 기도 시간 및 히자라 달력 지원
• 성능 최적화: XDG 준수 캐싱과 SHA-256 무결성 보호를 구현하여 외부 명령 실행 횟수와 지연을 최소화