GaoSSR/best-claude-hud

해결하는 문제

best-claude-hud는 터미널에서 Claude Code용 고성능 상태줄 도구입니다. 기본 상태줄을 활성 모델, 추론 노력, Git 상태, 컨텍스트 창 사용량과 같은 핵심 정보를 상세하고 사용자 정의 가능한 뷰로 대체합니다. 이 정보들은 일반적으로 세션 중에 덜 눈에 띄거나 추적하기 어려운 경우가 많습니다.

작동 방식

이 도구는 성능을 위해 Rust로 작성되었으며, statusLine 설정을 통해 Claude Code와 통합됩니다. Claude Code는 표준 입력(stdin)을 통해 실시간 상태 데이터(모델, 워크스페이스, 컨텍스트 창 등)를 도구에 전달합니다. 도구는 이를 처리한 후 ANSI 색상과 선택적 Nerd Font 기호를 사용하여 터미널에 포맷된 상태줄로 렌더링합니다.

대상 사용자

터미널에서 Claude Code를 사용하면서 AI 상호작용, 프로젝트 상태, 자원 사용량을 더 정보화되고 시각적으로 정리된 상태줄로 모니터링하고 싶은 개발자들.

주요 기능

• 포괄적인 모니터링: 모델 이름, 실시간 추론 노력(예: 낮음, 중간, 높음, 최대), 컨텍스트 창 사용량(토큰 수 및 퍼센트) 표시.
• 프로젝트 컨텍스트: 시작 디렉터리와 Git 브랜치 상태를 표시하며, 정리됨/변경됨 상태 및 앞서 있음/뒤처짐 카운트 포함.
• 사용자 정의 가능한 외관: TUI 설정 인터페이스와 여러 내장 테마(Gruvbox, Nord, Tokyo Night 등)를 제공하며, 사용자 정의 테마도 지원.
• 고성능: Rust로 구현되어 최소한의 오버헤드와 높은 반응성 보장.
• 프롬프트 노이즈 감소: Claude Code의 cli.js를 패치하여 컨텍스트 경고 노이즈를 줄이는 유틸리티 포함.