Skip to content

README_JA.md

Latest commit

 

History

History
259 lines (202 loc) · 13.7 KB

README_JA.md

File metadata and controls

259 lines (202 loc) · 13.7 KB
Raw
cc-statistics macOS App

cc-statistics

Claude Code、Gemini CLI、Codex CLI、Cursor を1つのネイティブ macOS アプリに統合した、唯一の AI コーディングトラッカーです。

すべての AI ツールの token、コスト、session を追跡。100% ローカル。ゼロ依存。

PyPI Downloads Stars License Zero Dependencies Platform

なぜ？ • 機能 • スクショ • クイックスタート • CLI • English | 简体中文 | 日本語 | 한국어

🤔 なぜ cc-statistics なのか？

複数の AI コーディングツールを使っていても、実際には把握できていないことがあります：

  • 💸 Claude Code、Gemini CLI、Codex、Cursor を合わせた総コストは？
  • 🔧 最も頻繁に呼ばれている MCP ツールは何で、その token コストは見合っているか？
  • ⏱️ Claude が実際に処理している時間と、あなたを待っている時間の比率は？
  • 📈 最もリソースを消費しているプロジェクトはどれで、どのモデルを使っているか？

ほとんどのツールは Claude Code だけに答えます。cc-statistics は4つすべてに答えます。

比較表

cc-statistics CCDash claude-usage ccflare
Claude Code ✅ ✅ ✅ ✅
Gemini CLI ✅ ❌ ❌ ❌
Codex CLI ✅ ❌ ❌ ❌
Cursor ✅ ❌ ❌ ❌
ネイティブ macOS アプリ ✅ ❌ ❌ ❌
ピクセルアートマスコット (Clawd) ✅ ❌ ❌ ❌
session 検索・再開 ✅ ✅ ❌ ❌
週次 / 月次レポート ✅ ✅ ❌ ❌
Webhook (Slack / Feishu / DingTalk) ✅ ✅ Slack/Discord ❌ ❌
ツール呼び出し分析 ✅ ✅ ❌ ❌
言語別コード変更量 ✅ ❌ ❌ ❌
AI vs ユーザー処理時間 ✅ ❌ ❌ ❌
使用量アラート ✅ ✅ ❌ ❌
使用量クォータ予測 ✅ ✅ ❌ ❌
session メッセージ共有 ✅ ❌ ❌ ❌
Web ダッシュボード ✅ ✅ ✅ ✅
CLI ツール ✅ ✅ ❌ ✅
ゼロ依存 ✅ ✅ ❌ ❌
cache 効率グレード ⏳ 予定 ✅ ❌ ❌
ライブストリーム ⏳ 予定 ✅ ❌ ❌

cc-statistics はコミュニティプロジェクトであり、Anthropic、Google、OpenAI とは無関係です。

🚀 機能

🌐 4プラットフォーム統合ビュー

Claude Code · Gemini CLI · Codex CLI · Cursor — プラットフォームを切り替えるか、4つすべてを1つのレポートに集約できます。各データソースはローカルファイルから読み取ります。API key 不要、アカウント不要、ネットワーク通信なし。

🖥️ ネイティブ macOS メニューバーアプリ

ビルド済み SwiftUI バイナリ — cc-stats-app を実行するとメニューバーに常駐します。Claude ロゴ + 本日の token 数 + 推定コストをひと目で確認できます。日次使用量クォータに達すると赤くなります。右クリックで表示モードを切り替え。グローバルホットキー Cmd+Shift+C でどこからでもフルダッシュボードを開けます。

🏝️ Claude スタイル Island オーバーレイ

ノッチ対応の Island オーバーレイで、コンパクト状態と展開状態で Claude Code のアクティビティや権限リクエストを表示します。常にターミナルに戻ることなく、承認の確認や chat コンテキストへの移動ができます。

🐾 Clawd — ピクセルアートステータスバーマスコット

ピクセルアートの Clawd マスコットが Claude Code の agent 状態にリアルタイムで反応します：アイドル、思考中、タイピング、ハッピー、スリープ、エラー — それぞれ独自のアニメーションスプライトつき。clawd-on-desk の hook 統合で実現。

Clawd Animation States

📊 使用量クォータ予測

現在の消費率に基づいて、いつ使用量クォータに達するかをリアルタイムで予測します。残り時間の見積もり、リセット予定時刻、リスクレベルを表示し、意図しない制限を避けられます。

🔍 session 検索・再開

すべてのプラットフォームのsession履歴をキーワードで横断検索できます。結果にはタイムスタンプとすぐに実行できる再開コマンドが表示されます — コピーペーストで即座にコンテキストに戻れます：

claude --resume <session-id>

💬 session メッセージ共有

個々のsession会話をきれいにフォーマットされたテキストとしてエクスポート・共有できます。AI支援作業の記録、チームメンバーとのコンテキスト共有、重要なsessionのアーカイブに便利です。

📊 多次元分析

指示回数 · ツール呼び出し Top 10（Skill と MCP ツールを名称別に分類）· AI 処理時間 vs ユーザーアクティブ時間 · 言語別コード変更量（git log --numstat 経由）· モデル別 token 内訳 · Opus / Sonnet / Haiku / Gemini 2.5 Pro / Flash / GPT-4o の内蔵価格によるコスト推算

🔔 使用量アラート

日次・週次のコスト上限を設定できます。閾値を超えると macOS メニューバーアイコンが赤くなり、ネイティブシステム通知が発火します — フォーカスモードに対応し、アプリをフォアグラウンドにする必要はありません。

📋 週次・月次レポート

任意の期間の Markdown サマリーを自動生成：総 token 数、モデル別コスト、最もアクティブなプロジェクト、上位ツール呼び出し、言語別コード変更。チームチャンネルに直接プッシュ：

cc-stats --report week
cc-stats --notify https://hooks.slack.com/services/xxx

Slack、Feishu、DingTalk の webhook に対応。

⚡ プロジェクト比較

プロジェクトごとのリソース消費量を並べて確認：

cc-stats --compare --since 1w

🌐 Web ダッシュボード

すべてのプラットフォーム対応のブラウザベース・ダークテーマダッシュボード — Linux/Windows や、メニューバーパネルより大きなビューが必要なときに便利です。

🔒 100% ローカル & ゼロ依存

すべてのデータはローカルファイルから読み取ります。ネットワーク経由で送信されるものは何もありません。Pure Python 標準ライブラリ — pip install 不要、npm 不要、Docker 不要。

🖼️ スクリーンショット

🖥️ macOS アプリ — ダークモード 🖥️ macOS アプリ — ライトモード
macOS App Dark macOS App Light
📊 使用量クォータ予測 🔴 最大使用量到達
Usage Quota Predictor Max Usage
🔍 session 一覧 🔧 ツール呼び出し分析
Session List Tool Call Analytics
⚡ Skill / MCP 分析 💬 session メッセージ共有
Skill Analytics Share Messages
🌐 4プラットフォーム統合ビュー ⚙️ 設定
Multi-Platform Settings
🔔 通知 🌐 Web ダッシュボード
Notifications Web Dashboard

CLI デモ

CC Stats CLI Demo

⚡ クイックスタート

前提条件

  • Python 3.8+
  • Claude Code CLI、Gemini CLI、Codex CLI、Cursor のいずれか1つ以上がインストール・使用済みであること

3ステップ

# 1. インストール
uv tool install cc-statistics   # または: pipx install cc-statistics

# 2. 最初のレポートを実行（全プラットフォーム、直近7日間）
cc-stats --all --since 7d

# 3. macOS メニューバーアプリを起動（macOS のみ）
cc-stats-app

設定ファイルは不要です。

その他のインストール方法：

# pipx
pipx install cc-statistics

# Homebrew (macOS / Linux)
brew install androidZzT/tap/cc-statistics

📖 CLI リファレンス

cc-stats                      # カレントディレクトリの session を分析
cc-stats --list               # 検出されたすべてのプロジェクトを一覧表示（全プラットフォーム）
cc-stats --all --since 3d     # 直近3日間、全プロジェクト、全プラットフォーム
cc-stats --all --since 1w     # 直近1週間
cc-stats myproject --last 3   # 特定プロジェクトの直近3 session
cc-stats --report week        # 週次 Markdown レポートを生成
cc-stats --report month       # 月次 Markdown レポートを生成
cc-stats --compare --since 1w # プロジェクト並列比較
cc-stats --notify <url>       # Slack / Feishu / DingTalk webhook にレポートをプッシュ
cc-stats-web                  # ブラウザで Web ダッシュボードを開く
cc-stats-app                  # macOS メニューバーアプリを起動

🗂️ データソース

すべてのデータはローカルファイルから読み取ります。ネットワーク経由で送信されるものは何もありません。

ソース ローカルパス
Claude Code ~/.claude/projects/<project>/<session>.jsonl
Gemini CLI ~/.gemini/tmp/<project>/chats/<session>.json
Codex CLI ~/.codex/sessions/*.jsonl
Cursor ~/Library/Application Support/Cursor/User/globalStorage/state.vscdb
Git 変更 プロジェクトディレクトリでの git log --numstat

謝辞

ステータスバーの Clawd アニメーションスプライトは clawd-on-desk より — AI コーディング agent の状態を hook で感知してピクセルアートアニメーションを再生する Electron デスクトップペットアプリです。

Farouq Aldori と claude-island / vibe-notch プロジェクトに特別な感謝を。macOS ノッチ island のインタラクションモデル、コンパクト/展開のモーション言語、承認パネルのデザイン方向性においてインスピレーションをいただきました。

サポート

cc-statistics が AI コーディングのコスト削減に役立っているなら、プロジェクトへのスポンサーをご検討ください。