Lifecycle Hook 기반 macOS Overlay를 통한 실시간 상태 시각화 구현

Context

TTS 기반 알림만으로는 사용자에게 주는 심리적 압박감과 가시성이 부족한 한계 존재. 단순 텍스트 알림을 넘어 물리적 존재감을 부여하는 실시간 시각적 피드백 시스템의 필요성 대두.

Technical Solution

• Claude Code의 PreToolUse 및 Stop Lifecycle Hook을 활용한 이벤트 트리거 설계
• 작업 시작과 종료 시점을 Temp File에 기록하는 Python 기반 상태 관리 로직 구현
• 500ms 주기의 파일 폴링을 통해 작업 경과 시간을 추적하는 macOS Swift 네이티브 앱 개발
• 터미널 윈도우(iTerm2, Warp 등)의 위치를 실시간 감지하여 상단에 Overlay 윈도우를 배치하는 포지셔닝 최적화
• 경과 시간에 따라 Idle, Stomping, Pacing, Whip 단계로 전이되는 상태 머신 기반 애니메이션 루프 적용
• 외부 의존성 및 Cloud 연결을 배제한 Local-first 아키텍처를 통한 지연 시간 최소화