jarrodwatts/claude-hud

해결하는 문제

Claude HUD는 사용자의 입력 아래에 항상 보이는 실시간 상태 표시줄(HUD)을 제공하는 Claude Code용 플러그인입니다. 사용자가 수동으로 시스템에 쿼리할 필요 없이 컨텍스트 윈도우 사용량, 활성 도구, 에이전트 진행 상황과 같은 Claude Code 세션의 내부 상태에 대한 가시성이 부족한 문제를 해결합니다.

작동 방식

이 플러그인은 Claude Code의 네이티브 statusline API를 활용합니다. stdin 및 transcript JSONL 파일에서 JSON 데이터를 처리하여 토큰, 도구 활동 및 에이전트 상태에 대한 정보를 추출합니다. 그런 다음 이 정보를 터미널에 서식화된 상태 표시줄로 렌더링하며, 원활한 성능을 보장하기 위해 300ms의 디바운스(debounce)를 적용하여 각 상호작용 후 다시 렌더링합니다.

대상 사용자

Claude Code를 사용하면서 세션의 리소스 사용량, 프로젝트 컨텍스트 및 AI의 현재 활동을 지속적으로 한눈에 파악하고 싶은 개발자.

주요 특징

• 실시간 모니터링: 컨텍스트 상태(시각적 바 포함), 사용률 제한 및 세션 지속 시간을 추적합니다.
• 도구 및 에이전트 추적: 활성 도구(read, edit, search) 및 실행 중인 서브 에이전트의 상태를 표시합니다.
• 프로젝트 컨텍스트: 현재 프로젝트 경로 및 Git 브랜치 상태(dirty 상태 포함)를 보여줍니다.
• 높은 커스터마이징 기능: 프리셋(Full, Essential, Minimal)과 레이아웃, 색상, 언어(English, Simplified Chinese, Traditional Chinese)를 위한 심층적인 설정 시스템을 제공합니다。
• 네이티브 통합: 별도의 창이나 tmux 없이도 모든 터미널에서 작동합니다.