Claude TimeTrack: macOSメニューバーアプリで、Claude CodeのJSONLファイルを読み取り、プロジェクトごとの開発時間を自動追跡

開発者がClaude TimeTrackというmacOSメニューバーアプリを公開しました。これはClaude Codeのセッションファイルとgit履歴を読み取って、プロジェクトごとに費やした時間を自動的に記録します。手動タイマーは不要。GitHubでMITライセンスのオープンソースとして公開されています。

仕組み

2つのデータソースを並べて表示:

• Claudeモード: ~/.claude/projects/ 以下のすべてのJSONLを解析し、各イベントをgitリポジトリのルートに対応付け、連続するイベントを「セッション」として連結。15分以上のギャップでセッションを分割するので、Claudeを一晩開いたままにしても時間が水増しされません。
• Gitモード: 各リポジトリで git log --no-merges --pretty=format:%aI を実行し、グローバルの user.email でフィルタリング。その後 git-hours ヒューリスティックを適用 — 2時間以内のギャップは連続作業とみなし、それ以上のギャップは新しいセッションとして扱い、最初のコミットに2時間を加算。両方の閾値は設定可能。HEAD SHAごとにリポジトリ単位でキャッシュされます。

各プロジェクトに両方の数値が表示されます。どちらかをタップしてアクティブビューを切り替えられます。

実際に表示されるもの

• メニューバーにライブ合計時間
• 今日 / 今週 / 全期間の切り替え
• GitHubスタイルの26週間アクティビティヒートマップ（集計表示とプロジェクト別表示）
• 任意の日をクリックしてドリルダウン（合計、ソート、セッションはすべてその日にスコープ）
• プロジェクトシェアの積み上げ内訳バー
• 直近20セッションまたはコミットサマリーを表示するプロジェクト詳細ビュー
• Claude Codeが古いセッションファイルを削除した場合のデータ欠落インジケーター

毎分自動更新、ログイン時に起動、関心のないプロジェクトは非表示にできます。

注意点

• macOS 14+のみ対応、Swiftで構築
• 公証済みリリースはまだなし — 付属のビルドスクリプトを使用してインストール
• Gitモードはgit履歴が必要、ClaudeモードはClaude Codeのセッションファイルが必要

対象ユーザー

複数のプロジェクトを並行して進めており、タイマーの開始/停止を意識せずに自動で受動的な時間追跡を求める開発者。