m1ckc3s/claude-status-bar

해결하는 문제

Claude Code 사용자는 AI가 '생각'하거나 도구를 실행하는 동안 터미널에서 기다려야 하는 경우가 많아, 다른 창에서 작업하는 동안 진행 상황을 추적하기 어렵습니다. 이 앱은 macOS 메뉴 막대에 지속적이고 한눈에 들어오는 상태 표시기를 제공하여, 사용자가 터미널로 다시 전환하지 않고도 Claude가 작업 중인지, 권한을 기다리는 중인지, 완료되었는지 확인할 수 있게 합니다.

작동 방식

이 앱은 상태 비저장(stateless) 방식으로, 사용자의 ~/.claude/settings.json 파일에 병합된 훅을 통해 Claude Code와 통합됩니다. Claude Code가 실행되는 동안 이 훅에서 업데이트를 폴링합니다. Claude Code 세션이 시작되면 앱이 자동으로 실행되고 모든 세션이 종료되면 자동으로 종료되며, 여러 라이브 세션의 상태 업데이트를 단일 메뉴 막대 아이콘으로 통합합니다.

대상 사용자

Claude Code(CLI, 데스크톱 앱 또는 Cursor 확장 프로그램)를 사용하며 백그라운드에서 AI 에이전트 워크플로우를 방해 없이 모니터링하려는 macOS 사용자.

주요 특징

• 실시간 상태 추적: 생각 중일 때는 애니메이션 아이콘, 권한 대기 중일 때는 노란색 점, 현재 턴에 대한 타이머를 표시합니다.
• 멀티 세션 지원: 여러 개의 Claude Code 세션을 동시에 처리하며, 사용자 권한이 필요한 세션을 우선적으로 표시합니다.
• 사용자 지정 가능한 시각 효과: 다양한 애니메이션 스타일(Spark, Unicode, Orbit 및 픽셀 아트 게)과 색상 옵션을 제공합니다.
• 멀티 서피스 호환성: Claude Code CLI, Claude 데스크톱 앱의 Code 탭, Cursor 확장 프로그램과 호환됩니다.
• 제로 관리: Claude Code 활동에 따라 자동으로 시작 및 종료됩니다.