caveman-stats について
caveman-stats は Caveman セッションの記録済み出力および キャッシュ読み取りトークンを集計する機能で、Claude Code では /caveman-stats で表示されます。節約量は推定せず、他のホストでは標準の使用量レポートを利用するよう案内します。
主な機能
- 01記録済みの出力トークンとキャッシュ読み取りトークンを表示
- 02--all と --since 7d で使用量を集計
- 03--share で共有可能な使用量レポートを出力
- 04数値を再計算せずにレポートをそのまま出力
活用シーン
- 01Claude Code での Caveman セッションの使用履歴の確認
- 02Gemini CLI で現在のセッション使用量を確認するコマンドの把握
- 03期間を指定した複数セッションの出力量の集計
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/caveman-statsを入力して読み込まれたか確認します。
同梱ファイルREADME.md
詳細
Claude Code では、src/hooks/caveman-mode-tracker.js が自身と同じ場所にある src/hooks/caveman-stats.js を解決し、/caveman-stats の実行時に実行します。このフックはプロンプトをブロックせず、レポートを hookSpecificOutput.additionalContext 経由で渡し、フェンス付きコードブロック内にそのまま出力するよう指示します。そのとおりに出力し、数値を自分で計算、再計算、丸め直ししないでください。
Gemini CLI では、現在のセッションのトークン使用量には /stats model、セッション統計には /stats session を案内してください。Gemini のカスタムコマンドはプロンプトであり、組み込みコマンドを呼び出したり、ライブのセッション指標を読み取ったりすることはできません。Gemini の使用量として Claude Code のトランスクリプトを読むことは絶対にしないでください。ほかのホストでは、利用可能であればネイティブの使用量レポートを使用し、そうでなければ現在のセッションの使用量は利用できないと伝えてください。Claude のリーダーと累積履歴が適用されるのは Claude Code のみです。測定済みの比較がないすべてのホストでは、削減量は不明のままです。
レポートには、記録された出力トークン数とキャッシュ読み取りトークン数、応答数、利用可能な場合はモードの帰属が表示されます。削減量は不明です。トランスクリプトには Caveman を使わなかった場合との測定済みの比較がありません。出力数や現在のモードから、削減トークン数、割合、金額、ルールのオーバーヘッド、純損益を推測しないでください。
--all と --since 7d は、セッションごとに直近で記録された出力数を集計します。--share は、削減量が不明であることを明記して、観測された使用量を報告します。履歴の est_saved_* フィールドは無視されます。元の履歴行はディスク上に残ります。ステータスラインには、廃止された削減量バッジではなく、アクティブなモードが表示されます。
元のメモリファイルと現在のメモリファイルの組み合わせは、測定されたバイト数で報告されます。これらのファイルサイズの差から、プロバイダーのトークン削減量や課金削減量が裏付けられるわけではありません。docs/HONEST-NUMBERS.md を参照してください。