mcpField
C
cost-track

cost-track

github.com/ruvnetエージェントワークフロー80.0k684 回インストール今日更新
リポジトリ

cost-track について

cost-track は、Claude Code のセッション使用量を読み取り、モデル別のコストを計算して AgentDB に記録するスキルです。セッション中や終了時の支出を記録し、コストレポートなどで利用できます。

主な機能

  1. 01Claude Code セッション JSONL の読み取り
  2. 02モデル別コストの計算
  3. 03AgentDB への記録保存
  4. 04セッションとパスの指定
  5. 05ドライランと JSON 出力

活用シーン

  1. 01作業の区切りで支出を記録
  2. 02セッション終了時の集計を保存
  3. 03長時間セッションで定期的に追跡

MCP 対応

MCP のメモリー検索ツールを使い、cost-tracking 名前空間の記録を確認します。MCP ツール自体は公開しません。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/ruvnet/ruflo --skill cost-track

インストール後、Claude Code で/cost-trackを入力して読み込まれたか確認します。

詳細

コスト追跡

アクティブな Claude Code セッションの jsonl（~/.claude/projects/<encoded-cwd>/<session>.jsonl）を読み込み、モデルごとにアシスタントメッセージの usage を集計し、REFERENCE.md の料金に基づいて USD コストを算出して、構造化されたレコードを cost-tracking AgentDB 名前空間に書き込みます。これは、cost-report と cost-optimize が実データを利用できるようにするプロデューサーです。

使用するタイミング

  • まとまった作業が終わった後に、レポート用の利用額を記録するとき。
  • セッション終了時に、最終的な集計結果を保存するとき。
  • 長時間のセッション中に定期的に記録するとき（cron での実行に適しています。/loop 30m を参照）。

手順

  1. プロジェクトのルートからトラッカーを実行します。

    node plugins/ruflo-cost-tracker/scripts/track.mjs

    スクリプトは、現在の作業ディレクトリからセッションの jsonl を自動検出します。特定のセッションを指定するには、TRACK_SESSION=/path/to/session.jsonl を設定します。ドライラン（メモリへの書き込みなし）を行うには、TRACK_DRY_RUN=1 を設定します。

  2. Markdown の概要を確認します。合計コスト、モデル別およびティア別の内訳、保存されたメモリキーが表示されます。

  3. 永続化を確認します。mcp__plugin_ruflo-core_ruflo__memory_search --query "session-" --namespace cost-tracking を実行すると、新しいレコードが表示されるはずです。cost-report の手順 1 では、この名前空間からデータを読み込みます。

レコードの形式（cost-tracking 名前空間）

キー：session-<sessionId>。値（JSON）：

{
  "sessionId": "1dba3b8c-...",
  "cwd": "/Users/cohen/Projects/ruflo",
  "startedAt": "2026-05-04T...",
  "endedAt": "2026-05-05T...",
  "messageCount": 234,
  "byModel": {
    "claude-opus-4-7": {
      "tier": "opus",
      "input_tokens": 12345,
      "output_tokens": 6789,
      "cache_creation_input_tokens": 800000,
      "cache_read_input_tokens": 2000000,
      "messages": 50,
      "cost_usd": 1.23
    }
  },
  "byTier": { "haiku": 0.0, "sonnet": 0.45, "opus": 1.23, "unknown": 0 },
  "total_cost_usd": 1.68,
  "capturedAt": "2026-05-05T..."
}

料金の正本

スクリプトの PRICING 定数は、REFERENCE.md の「Model pricing (USD per 1M tokens)」と同じ内容です。料金が変更された場合は、両方を更新してください。キャッシュ書き込みトークンには cache_write レートが、キャッシュ読み取りトークンには cache_read レートが適用されます（Anthropic の課金ドキュメントを参照）。

環境変数による上書き

環境変数デフォルト用途
TRACK_CWDprocess.cwd()スキャン対象のプロジェクトのセッションを指定します
TRACK_SESSION最新の jsonl特定のセッションファイルを指定します
TRACK_OUT未設定JSON の概要もこのパスに書き込みます
TRACK_DRY_RUN=1未設定memory store の呼び出しをスキップします
TRACK_QUIET=1未設定Markdown の出力を抑制します
TRACK_NAMESPACEcost-tracking書き込み先の名前空間を指定します

関連項目

  • cost-report（コンシューマー）— このスキルが生成したレコードを読み込みます
  • REFERENCE.md の「Cost attribution formula」— スクリプトが実装する計算式です
  • cost-budget-check（コンシューマー、P2 で公開予定）— 合計値を読み込み、アラートを評価します

コメント

Markdown 対応