Claudoro: Claude Code용 Pomodoro 타이머
Claudoro: Claude Code용 Pomodoro 타이머
Claudoro는 시간 관리를 Claude Code 터미널에 직접 통합합니다
Claudoro는 Claude Code 환경을 위해 특별히 설계된 Pomodoro 타이머로, 실시간 카운트다운과 사이클 트래커를 터미널의 상태 표시줄에 직접 삽입합니다. 개발자의 시선이 이미 집중돼 있는 곳에 타이머를 배치함으로써, 외부 앱, 브라우저 탭, 혹은 전화 알림과 같이 일반적으로 컨텍스트 전환을 일으키고 깊은 작업 흐름을 방해하는 요소들을 없애줍니다.
설치 및 설정
Claudoro는 Node.js 버전 22 이상이 필요합니다. npm을 통해 전역으로 설치하거나 개발을 위해 소스에서 설치할 수 있습니다.
설치 단계:
- npm으로 설치:
npm install -g claudoro - 초기화:
pomo setup명령을 실행해 도구를 Claude Code에 연결합니다. 이 과정은/pomo명령 파일을 생성하고,settings.json파일에 필요한statusLine구성을 병합합니다(백업을 만든 후).
설정이 완료되면, 새로운 Claude Code 세션에서 /pomo start 를 실행해 타이머를 시작할 수 있습니다.
핵심 기능 및 사용법
Claudoro는 타이머 상태의 단일 진실 원천을 제공하는 CLI 도구로, 해당 상태가 Claude Code 상태 표시줄에 반영됩니다. 모델 라운드 트립이 필요 없으며, API 토큰을 소모하지도 않습니다.
타이머 제어
사용자는 다음 명령을 통해 집중 세션을 관리할 수 있습니다:
/pomo start [mins]: 집중 블록을 시작합니다. 플래그를 사용해 기본값을 재정의할 수 있습니다:-w(작업),-s(짧은 휴식),-l(긴 휴식),-f(긴 휴식 빈도)./pomo pause | resume | stop: 현재 타이머 상태를 제어합니다./pomo skip: Pomodoro 사이클의 다음 단계로 이동합니다./pomo reset: 현재 단계를 다시 시작합니다./pomo extend [N]: 현재 단계에 N분을 추가합니다.
상태 표시줄 보기
Claudoro는 /pomo view <mode> 로 전환 가능한 세 가지 시각 모드를 제공합니다:
- Minimal: 타이머와 진행 바만 표시합니다 (
🍅 22:47 ▕████████░░▏). - Classic (Default): 긴 휴식까지의 진행을 나타내는 사이클 점을 추가합니다 (
🍅 22:47 ▕████████░░▏ ●●○○). - Full: 현재 작업 라벨을 상태 표시줄에 추가합니다 (
🍅 22:47 ▕████████░░▏ ●●○○ write tests).
전환 모드
다양한 작업 스타일을 지원하기 위해 Claudoro는 /pomo mode <mode> 로 선택 가능한 세 가지 전환 동작을 제공합니다:
- Auto (Default): 집중과 휴식 단계가 자동으로 전환됩니다.
- Balanced: 휴식은 자동으로 시작하지만, 다음 집중 블록은 수동 입력을 기다려 집중 시간을 낭비하지 않게 합니다.
- Manual: 모든 단계 전환이 수동으로 이루어지며, 깊은 흐름 작업에 이상적입니다.
데이터 관리 및 프라이버시
Claudoro는 로컬 우선 아키텍처를 따릅니다. 모든 데이터는 사용자의 머신에 있는 XDG 상태 디렉터리에 저장되며, 네트워크 요구사항, 계정, 텔레메트리가 없습니다.
- 로그 기록: 완료된 집중 블록은 일일 JSONL 로그에 불변 레코드로 저장됩니다. 모든 통계는 이러한 로그에서 파생되며, 카운터 형태로 저장되지 않아
pomo undo명령으로 레코드를 제거해도 데이터가 동기화 오류를 일으키지 않습니다. - 분석:
pomo stats명령은 터미널 기반 분석을 제공하며, 스트릭 및 집중 히트맵을 포함합니다.pomo stats --web을 실행하면 시각적 분석을 위한 자체 포함 HTML 대시보드가 생성됩니다. - 프라이버시: 생성된 HTML 대시보드는
~/.local/state/claudoro/dashboard.html에 로컬로 저장되며, 절대 서버에 업로드되지 않습니다.
기술 아키텍처 및 가드레일
시스템 설계
pomo CLI가 중앙 컨트롤러 역할을 합니다. 상태 표시줄과 /pomo 명령은 CLI와 통신하는 얇은 인터페이스이며, 독립적인 분리 프로세스가 알람(소리 및 OS 알림)을 처리해 터미널 세션이 종료돼도 알람이 작동하도록 합니다.
포기 방지 가드
타이머가 실수로 오래 실행돼 통계가 왜곡되는 것을 방지하기 위해 Claudoro는 포기 방지 가드를 구현합니다. 블록이 계획된 기간을 크게 초과해 실행될 경우(기본 30분 초과), 도구는 임계값까지의 집중 시간만을 기록하고 로그에 abandoned 로 표시합니다.
커뮤니티 인사이트
이 도구는 기존 워크플로에 통합된 점이 높이 평가되지만, 여러 AI 에이전트를 동시에 관리할 때 "깊은 작업"을 유지하는 데 어려움이 있다는 의견도 있습니다. 한 사용자는 다음과 같이 언급했습니다:
"If you're following Cal Newport-ian rules, watching over multiple agents doing their work is no longer a 25 minute 'deep work' Pomodoro."
다른 사용자들은 별도 생산성 앱보다 작고 통합된 도구가 더 가치 있다고 강조했으며, 별도 앱을 여는 마찰을 줄이는 것이 시스템 사용률을 높인다고 말했습니다.
요약: Claudoro는 Claude Code 상태 표시줄에 직접 삽입되는 풍부한 기능을 갖춘 Pomodoro 타이머로, 터미널 내에서 시간 추적을 유지함으로써 컨텍스트 전환을 없애줍니다.
제목: Claudoro: Claude Code용 Pomodoro 타이머