Show HN: Claudoro, Pomodoro timer embedded in the Claude Code statusline

개요

Claudoro는 Claude Code 터미널의 상태 줄에 내장된 Pomodoro 타이머로, 작업 중 시선 전환 없이 집중 시간을 관리할 수 있도록 설계되었습니다.

주요 내용

* 통합된 Pomodoro 타이머: 별도의 애플리케이션이나 탭 전환 없이 Claude Code의 상태 줄에 실시간으로 남은 시간을 표시하여 사용자의 집중력을 유지합니다.
* 상태 줄 렌더링: 기존 Pomodoro 도구와 달리 사용자가 이미 보고 있는 상태 줄에 타이머를 렌더링하여 추가적인 시선 이동이나 컨텍스트 전환을 요구하지 않습니다.
* 설치 및 설정: Node.js ≥ 22를 요구하며, npm을 통해 claudoro를 설치하고 pomo setup 명령어로 Claude Code에 통합됩니다. 개발 환경에서는 소스 코드에서 직접 설치 및 연동이 가능합니다.
* 다양한 명령어 지원: /pomo start, /pomo pause, /pomo resume, /pomo stop, /pomo skip, /pomo reset, /pomo next, /pomo back, /pomo extend 등 타이머 제어 및 조정을 위한 다양한 명령어를 제공합니다.
* 모드 및 보기 설정: pomo mode를 통해 auto, balanced, manual 모드를 설정할 수 있으며, pomo view 명령어로 minimal, classic, full 세 가지 보기 모드를 전환할 수 있습니다.
* 기록, 되돌리기 및 개인 정보 보호: 완료된 집중 시간은 로컬 JSONL 파일에 기록되며, pomo undo 및 pomo restore 명령어로 기록을 관리할 수 있습니다. 모든 데이터는 로컬에서 처리되며 네트워크 전송이나 원격 서버 저장이 없습니다.
* 통계 및 대시보드: pomo stats 명령어로 현재 스트릭, 집중 시간 히트맵, 태그별 집중 시간 등의 통계를 터미널에서 확인하거나, --web 옵션을 사용하여 독립 실행형 HTML 대시보드를 생성하여 브라우저로 볼 수 있습니다.
* 다중 세션 지원: 여러 Claude Code 세션에서 하나의 타이머가 공유되며, 모든 세션에서 제어가 가능하고 알람은 한 번만 발생합니다. CLAUDORO_HIDE 환경 변수로 특정 창에서 타이머를 숨길 수 있습니다.
* 환경 변수 제어: CLAUDORO_COLOR, CLAUDORO_EMOJI, CLAUDORO_LINKS, CLAUDORO_PASSTHROUGH 등의 환경 변수를 통해 타이머의 외형 및 동작을 세밀하게 제어할 수 있습니다.
* 문제 해결: 타이머가 멈추는 문제, 소리 알림 문제, 상태 줄 겹침 문제, 자동 실행 문제, 긴 시간 기록 문제 등에 대한 해결책을 제시합니다.
* 제거: pomo uninstall 명령어로 Claude Code에서 분리하고, npm uninstall -g claudoro로 전역 패키지를 제거할 수 있습니다. --purge 옵션으로 기록 및 설정 데이터를 함께 삭제할 수 있습니다.
* 작동 방식: Node.js 패키지로, CLI가 핵심 기능을 담당하며 상태 줄, 명령 파일, 알람은 CLI의 얇은 인터페이스 역할을 합니다. API 토큰 사용 없이 작동합니다.

시사점

Claudoro는 개발자의 집중력 유지를 위한 혁신적인 솔루션을 제공하며, IDE 내 통합을 통해 작업 흐름의 효율성을 극대화하고 컨텍스트 전환으로 인한 생산성 저하를 최소화합니다.