캡스로 깨운다

Claude Code 작업을 띄워둔 뒤 다른 창으로 넘어가면, permission prompt를 놓쳐 10분 뒤에야 멈춘 사실을 발견하는 문제가 있었다.

이 문제를 Caps Lock LED로 해결했다. 데스크톱 알림 대신, 멀리서도 보이는 물리적 신호를 깜빡여 Claude Code의 상태를 알려준다.

• -.- (K): Claude가 끝났고 이제 사용자 차례
• ..--.. (?): Claude가 질문을 했거나 입력이 필요함

구성은 다음과 같다.

• ~/.claude/settings.json에 전역 hook을 설치하고 백업/복원 가능하게 처리
• Node daemon이 Unix socket으로 상태를 받음
• Swift binary가 IOKit으로 LED를 토글
• 8초 idle-timer debounce로 긴 작업 중 중간 깜빡임을 줄임
• 터미널이나 에디터가 전면일 때는 블링크를 막는 focus guard 적용
• 시작 상태로 정확히 되돌리는 parity tracking 포함

설치는 npm install -g capsude 뒤 capsude를 실행하면 된다. 첫 실행 시 macOS Accessibility 권한이 필요하고, Xcode Command Line Tools와 **Node 18+**가 요구된다.

제약은 macOS 전용이라는 점이고, 프로젝트는 MIT 라이선스로 공개됐다.