ClaudeSessionsViewer

Claude Codeの履歴 を一覧・詳細表示して、検索することができるローカル Viewer です。覚えておきたい内容にラベルを貼り付けて、あとから検索することもできます。

• 本ツールは 日本語 / English / 简体中文 / 繁體中文 に対応しています。
• ご意見、ご要望はご遠慮なく issue に投稿ください。
• 初回起動は重いですが、キャッシュが入っているため、読込処理完了後は高速に動きます。
  • 近日中に、遅延処理を入れて高速起動化をする予定です。

画面構成

メイン画面

ラベル管理画面

ショートカットキーリスト画面

⭐ このプロジェクトが役に立ったら、Starしてもらえると嬉しいです！

👀 更新を追いたい方はWatchもぜひ！

起動方法

Releasesにあるapp-framework-dependentフォルダをダウンロード後、解凍してから中にあるrun.cmdを実行してください。

※本ツールの実行には.NET 10 SDK または.NET 10 Runtimeが必要となります。入っているか分からない、またはインストールしないことを望む場合、app-self-containedフォルダをダウンロードしてください。

---

※srcからビルドを行う場合、以下のようにPower Shell スクリプトを実行してください。

• 非自己完結版(.NET 10 SDK または.NET 10 Runtimeをインストール済の場合)

.\publish.ps1 -CleanOutput

• 自己完結版(.NET 10 SDK または.NET 10 Runtimeのインストール状況不明、インストールしない場合)

.\publish.ps1 -SelfContained -CleanOutput

デフォルト参照先

• Claude Code CLI
  • ~/.claude/projects
  • %USERPROFILE%\.claude\projects
  • WIN_HOME\.claude\projects（WIN_HOME 指定時）
  • /mnt/c/Users/*/.claude/projects
  • \\wsl.localhost\<distro>\home\*\.claude\projects（Windows 起動時に WSL ディストリを自動検出）
• Claude Desktop
  • %APPDATA%\Claude\IndexedDB
  • %USERPROFILE%\AppData\Roaming\Claude\IndexedDB
  • WIN_HOME\AppData\Roaming\Claude\IndexedDB（WIN_HOME 指定時）
  • /mnt/c/Users/*/AppData/Roaming/Claude/IndexedDB

画面機能

• ヘッダー
  • 右上に言語切替 (日本語 / English / 简体中文 / 繁體中文) と通貨切替 (USD / JPY / CNY / TWD / HKD) を配置
  • ラベル管理 / コスト表示 / メタ表示 / ショートカット / モバイル時の一覧表示切替を配置
  • ヘッダー下部に「今日の usage」サマリーを表示し、token・cost・score をすぐ確認可能
  • メタ表示 は既定で非表示。選択中セッションの session root / path / cwd / time / source / events / raw lines を確認可能
• 左ペイン
  • セッションリスト と ラベルリスト の 2 タブ構成
  • セッション一覧では source ラベル（Claude Code CLI / Claude Desktop）とセッションラベルを表示
  • 一覧上部に sessions: filtered/total の件数を表示
  • 新しい順 / 古い順 / 最終更新日時順 のタブで並び順を切り替え可能
  • Clear で左ペインの検索条件とフィルタ条件を初期化
  • フィルタを表示 / フィルタを隠す で検索・フィルタエリアを折りたたみ可能
  • 縦表示時はヘッダー右上の「一覧を隠す / 一覧を表示」で左ペイン全体を切り替え可能
• 左ペインの検索・フィルタ
  • cwd / キーワード / 開始日 / 終了日 / イベント開始日時 / イベント終了日時 / source / subagents / セッションラベル / イベントラベルで絞り込み
  • message だけでなく、function_call.arguments / function_output.output / agent_update.message もキーワード検索対象
  • キーワード欄ではダブルクォートで囲んだ語句を 1 つのフレーズとして扱える
    • 例: "Working Space" を 1 語として検索
  • cwd / 日時 / source / ラベル条件は常に AND 条件
  • AND/OR 切替はキーワード欄のみに適用
    • AND: スペース区切りキーワードをすべて含む
    • OR: スペース区切りキーワードのどれかを含む
  • イベント日時の時刻欄は、対応する日付を入れると有効化
  • フィルタ条件は次回起動時にも保持
• 左ペインのラベルリスト
  • ラベル付きセッションとラベル付きイベントを、ラベル別にまとめて表示
  • message / function_call / function_output / agent_update / token_usage の種別を区別して表示
  • 項目クリックで対象セッションや対象イベントへ移動可能
• 右ペイン: 選択セッションのイベント時系列表示
  • 初回詳細読み込み時はローディング表示、手動 Refresh 時は詳細更新中オーバーレイを表示
  • 詳細ツールバーは 表示 / 操作 / 検索 / 範囲選択 の構成
  • 詳細操作 / 検索 / 範囲選択 は必要なセクションだけ個別に開閉可能
  • セッション未選択時は表示系・検索系・範囲選択系の操作を無効化
• 右ペインの表示・操作
  • 表示条件: 「ユーザー指示のみ表示」 / 「AIレスポンスのみ表示」 / 「各入力と最終応答のみ」 / 「表示順を逆にする」 / 「token usageのみ表示」 / ラベルフィルター
  • コストソート で user message 単位のグループを トークントータル順 / コスト順 / score順 に並び替え可能
  • Refresh で選択中セッションだけを再取得
  • Clear で右ペイン全体の状態をリセット
    • 表示フィルタ
    • 詳細キーワード入力、フィルター / 検索 状態
    • 選択モード、選択済みイベント
    • 起点選択モード、起点、起点以前 / 以降表示
    • 開いているラベルピッカー
  • 「セッション再開コマンドコピー」で codex resume <セッションID> をコピー
  • 「表示中メッセージコピー」で現在表示中の message をまとめてコピー
  • セッションラベル表示と「セッションにラベル追加」
  • イベントごとのラベル表示 / 追加 / 削除
  • 各 message イベントに個別「コピー」ボタンを表示
• 右ペインの検索・選択
  • 詳細キーワードは フィルター と 検索 を分離
    • フィルター: キーワードを含むイベントだけを表示
    • 検索: 一致箇所をハイライトし、前へ / 次へ で移動
    • ヒット件数を current / total で表示
    • 検索をクリア: 入力欄、フィルター、検索状態をまとめて解除
  • 詳細キーワードは AND / OR ではなく、入力文字列そのままの部分一致
  • 検索対象は message / function_call / function_output / agent_update
  • 検索欄で Enter を押すと検索を実行し、そのままフォーカスを外して N / P で移動可能
  • イベント開始日時 / イベント終了日時 で、右ペインに表示するイベント時系列を絞り込み可能
  • 右ペインのイベント日時フィルタも date + time の分割入力で、時刻欄は日付入力後に有効化
  • 「選択モード」でイベントごとにチェックを付けて、「選択コピー」でまとめてコピー可能
    • フィルター適用中でも、すでに選択済みのイベントは保持
  • 「選択イベントのみ表示」で選択済みイベントだけに絞り込み可能
  • 「起点選択モード」で単一の message を選び、「起点以降のみ表示」 / 「起点以前のみ表示」で絞り込み可能
• イベント表示
  • message（user / assistant / developer）
  • user は薄青背景、AGENTS.md や environment_context などの実行コンテキストはグレー背景
  • function_call / function_output
  • agent_update
  • token_usage
• ラベル管理
  • 右上の「ラベル管理」ボタンから別ウィンドウで開く
  • メイン画面と同じ言語設定を共有
  • セッションラベル / イベントラベルを共通管理
  • ラベル色は #hex / rgb(...) / oklch(...) を直接入力、または色プリセットから選択可能
  • ラベル追加系 UI でも色付きのまま候補を確認可能
• コスト表示
  • 右上の「コスト表示」ボタンから別ウィンドウで開く
  • 通貨設定に応じて cost 表示を切り替えながら、usage の集計を確認可能

ショートカットキー

入力欄にカーソルがある間は、ショートカットは実行されません。Esc でショートカット一覧やラベルピッカーを閉じるか、検索入力からカーソルを外せます。

キー	動作
F5	表示中の一覧またはセッション詳細を更新
Shift + F	左ペインのフィルタ表示を切り替え
Shift + L	左ペインの Clear を実行
/	検索入力欄にフォーカス
N	詳細検索の次のヒットへ移動
P	詳細検索の前のヒットへ移動
M	path / cwd / time のメタ表示を切り替え
[	前のセッションを開く
]	次のセッションを開く
1	「ユーザー指示のみ表示」を切り替え
2	「AIレスポンスのみ表示」を切り替え
3	「各入力と最終応答のみ」を切り替え
4	「表示順を逆にする」を切り替え
5	「token usageのみ表示」を切り替え
Shift + D	右ペインの Clear を実行
Shift + T	詳細操作の表示と非表示を切り替え
Shift + R	セッション再開コマンドをコピー（claude --resume <セッションID>）
Shift + C	表示中メッセージをコピー
Shift + S	選択モードの開始と終了を切り替え
Shift + X	選択中メッセージをコピー
Shift + G	起点選択モードの開始と終了を切り替え
Shift + H	起点を解除
,	起点以前のみ表示
.	起点以降のみ表示
Esc	ショートカット一覧やラベル追加ポップアップを閉じ、検索入力欄からカーソルを外す

重要な制約

• Claude Code CLI（JSONL）は構造化して表示できます。
• Claude Desktop（IndexedDB/LevelDB）については、以下の仕様・制約があります。

Claude Desktop のデータ構造について

調査の結果、Claude Desktop が %APPDATA%\Claude\IndexedDB\ に保存しているのは 送信前のチャット下書きメッセージのみ であることが判明しました。

項目	説明
保存されるデータ	チャット入力欄の下書き（未送信メッセージ）
保存されないデータ	送信済みの会話履歴（ユーザー発話・AI 応答）
送信済み会話の保存先	Anthropic のサーバー側（ローカルには存在しない）

本 Viewer は LevelDB ログファイル（.log）を正式にパースし、下書きメッセージを正確に表示します。

• LevelDB WriteBatch レコードをブロック単位でデコード
• Chromium IndexedDB の文字列キー（UTF-16BE）を復元
• Blink SerializedScriptValue のヘッダーをスキップし、UTF-16LE の JSON を抽出
• TipTap / ProseMirror ドキュメントツリーからプレーンテキストを収集

なぜ会話履歴が見えないのか
Claude Desktop は claude.ai の Web アプリを Electron でラップしたものです。会話履歴は Anthropic のクラウドに保存され、ローカルの IndexedDB には同期されません。そのため、本 Viewer で表示できるのは現在入力中の下書きのみとなります。

補足

• ラベルデータは .cache/label-store-claude.json に保存されます。
• Claude Code / Claude Desktop の実データが 1 件も見つからない場合は、同梱の sample-data/claude/projects をダミーデータとして自動表示します。
• 明示的に参照先を変えたい場合は CLAUDE_SESSIONS_DIR または SESSIONS_DIR で Claude Code CLI のルートを指定できます。
• Windows 環境では wsl.exe -l -q を使って WSL ディストリを列挙し、各ディストリの ~/.claude/projects も自動探索します。
• 自動検出対象のディストリを絞る場合は CLAUDE_WSL_DISTROS を指定できます（例: Ubuntu;Debian）。
• 大量ログ対策で一覧最大 400 件、イベント最大 4000 件に制限しています。
• Viewer はデフォルトでローカル専用 (127.0.0.1) で待ち受けます。

ファイル構成

.
├── .gitignore                           # ルートの除外設定
├── LICENSE                              # ライセンス
├── README.md                            # 日本語README
├── README_en.md                         # 英語README
├── publish.ps1                          # 配布用 publish スクリプト
├── image/
│   ├── 00001.jpg                        # README掲載用のメイン画面サンプル
│   ├── 00002.jpg                        # README掲載用のラベル管理画面サンプル
│   └── 00003.jpg                        # README掲載用のショートカット画面サンプル
└── src/
    ├── .cache/
    │   └── label-store-claude.json      # ラベル定義と紐付けの保存先
    ├── ClaudeSessionsViewer.sln         # ソリューション
    ├── ClaudeSessionsViewer.csproj      # ASP.NET Core / Blazor プロジェクト定義
    ├── Program.cs                       # アプリ起動、URL設定、APIエンドポイント定義
    ├── appsettings.json                 # 本番向け設定
    ├── appsettings.Development.json     # 開発向け設定
    ├── Components/
    │   ├── App.razor                    # HTMLルートと共通スクリプト読込
    │   ├── Routes.razor                 # ルーティング定義
    │   ├── _Imports.razor               # Razor 共通 using
    │   ├── Layout/
    │   │   ├── MainLayout.razor         # 共通レイアウト
    │   │   ├── MainLayout.razor.css     # 共通レイアウト用スタイル
    │   │   ├── ReconnectModal.razor     # 再接続モーダル UI
    │   │   ├── ReconnectModal.razor.css # 再接続モーダル用スタイル
    │   │   └── ReconnectModal.razor.js  # 再接続モーダル用スクリプト
    │   └── Pages/
    │       ├── Error.razor              # エラー画面
    │       ├── Home.razor               # メイン画面
    │       ├── Labels.razor             # ラベル管理画面
    │       └── NotFound.razor           # 404画面
    ├── Models/
    │   └── ViewerDtos.cs                # APIレスポンス/リクエスト用 DTO
    ├── Properties/
    │   ├── AssemblyInfo.cs              # バージョン情報
    │   └── launchSettings.json          # ローカル開発用起動設定
    ├── Services/
    │   ├── LabelStore.cs                # ラベル保存・検証ロジック
    │   └── ViewerService.cs             # セッション探索・読込・検索ロジック
    └── wwwroot/
        ├── app.css                      # 全体共通スタイル
        ├── css/
        │   ├── labels.css               # ラベル管理画面用スタイル
        │   └── viewer.css               # メイン画面用スタイル
        ├── icons/
        │   ├── claude-sessions-viewer.svg # アプリアイコン（Claude版）
        │   └── codex-sessions-viewer.svg  # アプリアイコン（Codex版）
        └── js/
            ├── labels.js                # ラベル管理画面用スクリプト
            └── viewer.js                # メイン画面用スクリプト

❗このプロジェクトは MIT ライセンスの下で提供されています。詳細は LICENSE ファイルをご覧ください。