m1ckc3s/claude-status-bar

해결하는 문제

Claude Code 사용자는 AI가 "생각"하거나 터미널에서 도구를 실행하는 동안 기다려야 하는 경우가 많아, 터미널 창을 항상 집중시켜 두지 않으면 AI가 활성화되었는지, 또는 사용자 승인을 기다리는지 알기 어렵습니다. 이 앱은 macOS 메뉴 바에 시각적 인디케이터를 제공하여, 사용자가 터미널에서 벗어나 있어도 AI 상태를 한눈에 확인할 수 있도록 합니다.

작동 방식

이 앱은 상태가 없는(stateless) 형태로, ~/.claude/settings.json 파일에 병합된 훅을 통해 Claude Code와 통합됩니다. Claude Code가 실행되는 동안 이러한 훅에서 업데이트를 주기적으로 확인합니다. Claude Code 세션이 시작되면 앱이 자동으로 실행되고, 활성 세션이 없으면 종료되며, 여러 개의 활성 세션에서 온 상태 업데이트를 하나의 메뉴 바 아이콘으로 집계합니다.

대상 사용자

Claude Code(CLI, 데스크톱 앱, 또는 Cursor 확장)를 사용하는 macOS 사용자 중, AI의 활동 및 승인 요청을 방해하지 않는 방식으로 추적하고 싶은 사용자.

주요 기능

• 실시간 상태 추적: 생각 중/작업 중일 때는 애니메이션 아이콘, 승인 대기 시에는 노란 점, 현재 턴의 경과 시간은 타이머로 표시.
• 도구 사용 레이블 표시: Claude가 도구를 사용할 때 "편집 중", "읽기 중", "명령 실행 중" 등의 레이블을 표시.
• 다중 세션 지원: 승인 대기 중인 세션을 생각 중인 세션보다 우선시하여 사용자가 차단되지 않도록 합니다.
• 사용자 정의 가능한 시각 효과: Claude Spark, Claude Code 글리프, 또는 픽셀 아트 게으른 게임 등 다양한 애니메이션 스타일과 색상 옵션(오렌지 또는 시스템 적응) 제공.
• 가볍고 도크 없이 사용 가능: 사용량 대시보드 없이 가벼운 경험 제공.