tldr-stats

TLDR 統計スキル

トークン使用量、実際の API コスト、TLDR による節約額、フックの稼働状況を、美しいダッシュボードで表示します。

使用する場面

• TLDR によって実際に何ドル節約できているか確認する
• セッション全体のトークン使用量とコストを確認する
• TLDR の効果を導入前後で比較する
• TLDR／フックが使われているかデバッグする
• 使用中のモデルを確認する

手順

重要： スクリプトを実行し、出力をユーザーに表示してください。

1. 統計スクリプトを実行します。

python3 $CLAUDE_PROJECT_DIR/.claude/scripts/tldr_stats.py

2. 出力全体を回答にコピーして、チャット上でダッシュボードをユーザーに表示してください。 コマンドを実行するだけで、結果を表示しないでください。ユーザーは統計情報を確認したいと考えています。

出力例

╔══════════════════════════════════════════════════════════════╗
║  📊 Session Stats                                            ║
╚══════════════════════════════════════════════════════════════╝

  You've spent  $96.52  this session

  Tokens Used
        1.2M sent to Claude
      416.3K received back
       97.8K from prompt cache (8% reused)

  TLDR Savings

    You sent:               1.2M
    Without TLDR:           2.5M

    💰 TLDR saved you ~$18.83
    (Without TLDR: $115.35 → With TLDR: $96.52)

    File reads: 1.3M → 20.9K █████████░ 98% smaller

  TLDR Cache
    Re-reading the same file? TLDR remembers it.
    █████░░░░░░░░░░ 37% cache hits
    (35 reused / 60 parsed fresh)

  Hooks: 553 calls (✓ all ok)
  History: █▃▄ ▇▃▇▆ avg 84% compression
  Daemon: 24m up │ 3 sessions

数値の見方

指標	意味
使用額	このセッションで Claude API に実際に使用した金額
送信量／TLDR なしの場合	実際のトークン数と、TLDR がなかった場合のトークン数
TLDR による節約額	ファイル読み込みを圧縮して節約できた金額
ファイル読み込み X → Y	TLDR の要約に圧縮されたファイルの生トークン数
キャッシュヒット	TLDR が解析済みファイルの結果を再利用した回数
履歴スパークライン	最近のセッションにおける圧縮率（█ = 高）

視覚要素

• プログレスバーで節約額とキャッシュ効率を一目で確認できます
• スパークラインで過去の傾向を確認できます（█ = 節約率が高い、▁ = 低い）
• 色で状態を示します（緑 = 良好、黄 = 中程度、赤 = 要注意）
• 絵文字でモデルの種類を区別します（🎭 Opus、🎵 Sonnet、🍃 Haiku）

注意事項

• トークンの節約量はファイルサイズによって異なります（大きなファイルほど節約量が増えます）
• キャッシュヒット率は最初は低く、ファイルを再読み込みするにつれて上がります
• コストの推定には、Opus $15/1M、Sonnet $3/1M、Haiku $0.25/1M を使用します
• 作業中、統計情報はリアルタイムで更新されます