daaain/claude-code-log

A Python CLI tool that converts Claude Code transcript JSONL files into readable HTML / Markdown format.

Claude Code Log – 何であるか

Claude Code（Anthropic の IDE アシスタント）が生成する JSONL トランスク립トファイルを読み取り、クリーンで閲覧可能な HTML または Markdown ログに変換する小さな Python コマンドラインユーティリティです。

なぜ存在するのか

Claude Code は、すべてのプロンプト、応答、ツール呼び出し、システムコマンドを1行ずつの JSON レコードとして保存します。これらの生データは人間が読んだり共有したりするのは困難です。Claude Code Log は自動変換を実行し、ナビゲーション、トークン使用量統計、日付範囲フィルタリング、ターミナル UI を追加することで、以下を可能にします：

単一のセッションまたは ~/.claude/projects/ ツリー全体を確認できます。
任意の LLM に分析用にフィードバック可能なコンパクトな Markdown ダンプをエクスポートできます。
会話のタイムラインを可視化し、メッセージタイプをフィルタリングし、各部分が消費したトークン数を確認できます。

コア機能（README に記載）

機能	機能内容
インタラクティブ TUI	セッションの閲覧、HTML/MD の生成、セッションの再開、およびクイック統計を提供するターミナル UI。
プロジェクト全体処理	`~/.claude/projects/` をスキャンし、各プロジェクトのカードと、プロジェクトごとの統合トランスク립トを含むトップレベルのインデックスページを作成。
単一ファイル/ディレクトリモード	個別の `transcript.jsonl` またはそれらのディレクトリを変換可能。
HTML エクスポート	最小限でレスポンシブなページ。構文強調付きコード、実行時 JavaScript フィルタ、トークンカウンター、浮動型トップに戻るボタンを備える。
Markdown エクスポート	GitHub フレーバーの Markdown；`--compact` で連続する同タイプのセクションをマージ、`--detail` で詳細度を制御。
トークン使用量追跡	メッセージごと、セッションごとのトークン数を表示。
日付範囲フィルタリング	自然言語形式の日付（`"yesterday"`、`"last week"` など）で出力範囲を制限。
Git SHA リンク	SHA に似た文字列を検出し、GitHub/GitLab/Bitbucket またはカスタム URL テンプレートへのクリック可能なリンクに変換。
豊富なメッセージ対応	ユーザー、アシスタント、システム、ツール使用/結果、思考、画像メッセージをすべて対応。
複数セッションの要約一致	非同期に到着する Claude 生成要約と元のセッションを一致させる。
プロバイダーフック（実験的）	`--provider` を通じて Antigravity CLI（`agy`）や Codex CLI（`codex`）からの直接エクスポートを可能に。

一般的な利用ケース

個人の監査 – 「先週、Claude と何をやったか？」→ claude-code-log --from-date "last week" --open-browser を実行。
コスト追跡 – セッションごとのトークン使用量で Claude Code のコストを推定可能。
共有 – セッションを HTML でエクスポートし、チームメートにリンクを送信。
LLM による分析 – コンパクトな Markdown ダンプ（--detail low --format md --compact）を生成し、別のモデルにフィードしてパターン検出や要件抽出を実行。
バージョン管理リンク – クリック可能なコミットハッシュにより、会話から直接関連するコード変更にジャンプ可能。

使い始め

# 永続的インストールなしのワンライナー
uvx claude-code-log@latest --open-browser

# または pip でインストール
pip install claude-code-log

# 基本コマンド
claude-code-log               # すべての ~/.claude/projects/ を処理し、index.html を開く
claude-code-log my-project --tui   # 単一プロジェクト用のターミナル UI を起動
claude-code-log transcript.jsonl -o session.md --detail low --format md --compact

拡張性とコミュニティ

プロジェクトには CONTRIBUTING.md が同梱されており、テストとアーキテクチャのノートが記載されています。
コミュニティ拡張として、チャット内での使用を可能にする archive-session スキル/コマンドがあります。
TODO リストには UI チュートリアル、並列処理、Git worktree マージ、GitHub Action ラッパーの追加が記載されています。

上記のすべての情報はリポジトリの README から直接取得；追加の仮定は一切ありません。*