Tokmeter — AI Agent Usage & Cost

---

理由

エージェントごとに別々に請求され、表示されるのもそれぞれの利用分だけです。Claude CodeはClaude Codeのコストを把握し、CodexはCodexのコストを把握しています。今日かかったコストや、どのプロジェクトがひそかに最もコストを消費しているか、切り替えたモデルが実際に自分の作業で安くなるのかを把握できるものはありません。

Tokmeterは、すでにディスク上にあるデータからその答えを導き出します。各エージェントのローカルなセッションログを解析し、最新のモデルカタログに基づいて価格を計算し、追記専用の日次台帳に記録するため、エージェントがログをローテーションして削除した後も履歴が残ります。

npx @sriinnu/tokmeter --today

ドキュメントとテーマギャラリーはこちらです：tokmeter.srinivas.dev。

表示例

CLI — プロジェクト、モデル、プロバイダー別の使用状況	ダイジェスト — 週間レポートカード

ほかにも、ターミナルUI（tokmeter-tui）、ローカルのウェブダッシュボード、Claude Code用ステータスライン、エージェントが自身の支出を照会できるMCP サーバーがあります。

インストール

Node.js 18+が必要です。セッションファイルの読み取りにプロバイダーの認証情報は不要です。価格の照会では公開カタログを取得しますが、--lightを指定すれば取得を省略できます。

# Try it without installing
npx @sriinnu/tokmeter --today

# Install the CLI, and the daemon/MCP server
npm install -g @sriinnu/tokmeter @sriinnu/tokmeter-mcp

パッケージ	内容
@sriinnu/tokmeter	コアAPI、CLI、ターミナルUI
@sriinnu/tokmeter-mcp	MCP サーバー、デーモン、ステータスライン、ライブターミナルUI

packages/core、packages/cli、packages/tuiは、@sriinnu/tokmeterにバンドルされるプライベートワークスペースパッケージです。packages/webは、ソースから実行する独立したプライベートワークスペースアプリです。

デーモンを常時稼働させ（メニューバーとステータスラインを再起動後も利用できるようにする）には、launchdエージェントを一度インストールしてください：tokmeter-mcp daemon install-agent（macOS）。ログイン時に自動起動し、クラッシュした場合も再起動します。

主な検証対象はClaude CodeとCodexです。その他のパーサーと既知の制限については、プロバイダーの互換性をご覧ください。

CLI

tokmeter --today
tokmeter models --project my-app --json
tokmeter daily --week
tokmeter projects
tokmeter stats --month
tokmeter digest --period week
tokmeter pricing sonnet

フィルターには、--project、--claude、--codex、--week、--month、--since YYYY-MM-DD --until YYYY-MM-DDがあります。機械可読な出力には--json、トークンのみのレポートには--lightを使用してください。

• エイリアス：表示名の統合、プロジェクトのタグ付け、または一覧からの非表示ができます。
• バックアップと復元：ポータブルなスナップショット、クリーンアップのプレビュー、復元ができます。クリーンアップではソースファイルが削除されるため、確認とバックアップの手順を必ず実行してください。
• CLI リファレンス：すべてのコマンドを例とともに紹介しています。
• 数値の仕組み：各分類の意味と、推定値がどこで使われるかを説明しています。

TypeScript API

ルートのエクスポートではコア API を利用できます。便利なクエリヘルパーは/cliサブパスを使用します。

import { TokmeterCore } from "@sriinnu/tokmeter";
import { loadTokmeterSummary } from "@sriinnu/tokmeter/cli";

const core = new TokmeterCore();
await core.scan({ providers: ["codex", "claude-code"], today: true });
const models = core.getModelCosts();
const daily = core.getDailyBreakdown();

const summary = await loadTokmeterSummary({ week: true, light: true });

複数の内訳をクエリする場合は、コアのスキャンを再利用してください。統合ガイド、コア API の使用方法、およびエージェント向けの統合手順を記載したSKILL.mdを参照してください。

デーモン、MCP、ステータスライン

tokmeter-mcp daemon start
tokmeter-mcp daemon status
tokmeter-mcp serve             # MCP server over stdio
tokmeter-mcp statusline        # one statusline tick
tokmeter-mcp live              # live terminal UI

デーモンは、クエリ用にローカル HTTP ポート9877を、ライブ登録用に WebSocket ポート9876を使用します。プライベートな読み取りと WebSocket 接続には、~/.tokmeter/daemon/daemon.tokenにあるユーザーごとのトークンが必要です。/api/readyは公開ヘルスチェックです。macOS アプリ、ステータスライン、MCP サーバーは、使用時にその認証情報を読み込みます。デーモンのコマンドは@sriinnu/tokmeter-mcpに属します。これらの機能を利用するには、同パッケージをインストールしてください。

MCP ツールにはtokmeter_プレフィックスが付き、使用状況のクエリ、比較、予測、エクスポート、確認付きのクリーンアップ／復元操作に対応しています。目的別に分類された全24個のツールについてはMCP ツールリファレンスを、設定とプログラムからのエクスポートについてはパッケージの MCP READMEを参照してください。

tokmeter-mcp editorsはインストール対象を一覧表示します。tokmeter-mcp install-mcpとtokmeter-mcp install-statuslineはエディターの設定を書き込みます。生成された設定をエディターで確認してください。Claude Code の場合は、claude mcp add tokmeter --scope user -- npx -y @sriinnu/tokmeter-mcp serveでMCP サーバーを登録してください（1.15.0以降では、install-mcpがclaude mcp addを自動実行します。1.14.1以前では、Claude Code が読み込まない~/.claude/settings.jsonにエントリーを書き込んでいました）。登録、認証、更新、ストレージ、デーモンのライフサイクルについてはアーキテクチャを参照してください。

ターミナルとウェブのインターフェース

# After installing @sriinnu/tokmeter
tokmeter-tui

# Without a global install
npx -p @sriinnu/tokmeter tokmeter-tui

ターミナル UI では、概要、モデル、日別、統計、クリーンアップの各ビューを利用できます。キーとコマンドを参照してください。

ソースをチェックアウトした環境からウェブワークスペースを実行します。

bun install
bun run dev:web

http://localhost:3000を開いてください。ウェブのセットアップとデータソースを参照してください。

macOS アプリ

リリースビルドの対象は Apple silicon および macOS 14 以降です。ローカルデーモンには Node.js 18 以降と npx も必要です。

@sriinnu/tokmeter-mcp をインストールし、tokmeter-mcp daemon start を実行してから、/Applications から TokmeterBar を開いてください。アプリは GitHub Releases からダウンロードできます。

ポップアップでは、本日のトークン数と推定 API コストを同等の目立ちやすさで表示し、その下にモデルとプロジェクトを表示します。チャートのホバーカードには、日ごとの正確なトークン数とコストが表示されます。Usage details を展開すると、累計、トレンド、シグナルが表示されます。テーマは Terminal、Paper、Prism、Lagoon、Carbon、Glass、および（1.15.0 以降）計器テーマの Meter、Pump、Rams、Deck、Passbook です。モデル一覧のヘッダーにある $/M ボタンを押すと、各モデルの 100 万トークンあたりの定価（入力、出力、キャッシュ読み取り、キャッシュ書き込み）と、その価格の出典が表示されます。ダッシュボードのポートは設定可能です。Hub では、より詳細な内訳と設定を利用できます。設定 → Open web dashboard を選ぶと、必要に応じてローカルサーバーが起動します。Stop web dashboard を選ぶかアプリを終了すると、サーバーは停止します。

macOS のビルドとランタイムの詳細、初回使用時の確認事項、ポップオーバーの検証をご覧ください。完了状況トラッカーでは、新しいマシンでの確認、信頼性、アップデート、会計、アクセシビリティ、試用に関する残りの確認事項を記録しています。

合成データを使った操作例では、サンプル画像の生成方法を説明しています。現在のローカル候補をキャプチャしたものではありません。

ドキュメント

• MCP ツールリファレンス — 24 種類すべての tokmeter_ ツールをグループ別に紹介
• tokmeter の利用方法 — MCP、デーモン HTTP、CLI、プロセス内での統合
• 数値の仕組み — バケットの意味と推定値が使われる箇所
• バックアップ、スナップショット、復元 — 確認とバックアップのモデル、およびマシン間の復元
• トラブルシューティング — デーモン、バーの更新、「縮小する」履歴、パフォーマンス
• アーキテクチャ — デーモンのライフサイクル、ストレージ、更新

プライバシー

すべての処理はお使いのマシン上で実行されます。Tokmeter はエージェントがすでに書き込んだセッションファイルを読み取ります。プロバイダーの認証情報は不要で、テレメトリは送信せず、アカウントも必要ありません。外部へのリクエストは、公開モデル価格カタログの任意の取得のみです。この取得は --light ですべて省略されます。使用状況データがお使いのデバイスから外部に送信されることはありません。

サポート

Tokmeter は無料のオープンソースソフトウェアです。役に立った場合は、メンテナンスの継続にご協力いただけると幸いです。

• GitHub Sponsors
• Buy Me a Coffee

ライセンス

AGPL-3.0-only。Tokmeter を別の製品に組み込む場合の意味については、ライセンスに関する注記をご覧ください。