Claude TimeTrack: macOS 메뉴바 앱으로 Claude Code JSONL 파일을 읽어 프로젝트별 개발 시간을 자동 추적

한 개발자가 만든 macOS 메뉴바 앱 Claude TimeTrack은 Claude Code의 세션 파일과 git 히스토리를 읽어 프로젝트별 작업 시간을 자동으로 추적합니다. 수동 타이머가 필요 없으며, GitHub에서 오픈소스(MIT)로 제공됩니다.

작동 방식

두 가지 데이터 소스를 나란히 보여줍니다:

• Claude 모드: ~/.claude/projects/ 아래의 모든 JSONL 파일을 파싱하고, 각 이벤트를 해당 git 저장소 루트로 연결하며 연속된 이벤트를 '세션'으로 묶습니다. 15분 이상의 간격은 세션을 분리하므로, Claude를 밤새 열어둬도 시간이 부풀려지지 않습니다.
• Git 모드: 각 저장소에 대해 전역 user.email로 필터링된 git log --no-merges --pretty=format:%aI를 실행하고, git-hours 휴리스틱을 적용합니다. 2시간 이하의 간격은 연속 작업으로, 그 이상은 새 세션으로 간주하며 시작 커밋에 2시간을 추가로 부여합니다. 두 임계값은 설정 가능합니다. HEAD SHA별로 저장소별로 캐싱됩니다.

각 프로젝트는 두 수치를 모두 표시합니다. 하나를 탭하면 활성 뷰가 전환됩니다.

실제로 보이는 것

• 메뉴바의 실시간 총계
• 오늘 / 주간 / 전체 기간 전환
• GitHub 스타일 26주 활동 히트맵 (전체 및 프로젝트별 집계)
• 날짜를 클릭하면 상세 정보 확인 (총계, 정렬, 세션이 해당 날짜로 범위 지정)
• 프로젝트 점유율의 누적 분해 막대
• 프로젝트 상세 보기 (최근 20개 세션 또는 커밋 요약)
• Claude Code가 오래된 세션 파일을 정리한 경우 데이터 누락 표시

매분 자동 새로고침, 로그인 시 실행, 중요하지 않은 프로젝트 숨기기 가능.

주의사항

• macOS 14+ 전용, Swift로 제작
• 아직 공증된 릴리스 없음 — 포함된 빌드 스크립트로 설치
• Git 모드는 git 히스토리가 필요하며, Claude 모드는 Claude Code 세션 파일이 필요

대상 사용자

여러 프로젝트를 병렬로 작업하며, 타이머를 시작/중지할 필요 없이 자동 수동 시간 추적을 원하는 개발자.