mcpField
T
TokenTrace

TokenTrace

ローカル
baseframelabs.comデータ・分析018 週間前に更新

TokenTrace について

TokenTraceは、AIコマンドラインツールの利用状況を確認する、開発者やコーディングエージェント向けのローカル優先CLIとダッシュボードです。ローカル記録をスキャンし、トークン数やコストの確度を示して、クラウドに利用データを送らずに根拠の確認と修正を行えます。

主な機能

  1. 01ローカルのAI CLI利用記録をスキャン
  2. 02トークン数とコストの確度を表示
  3. 03指標を元データまで追跡
  4. 04コスト、セッション、異常を確認
  5. 05不足するコストデータをローカルで修正
  6. 06MCPツールとCLIコマンドを提供

活用シーン

  1. 01エージェント実行前に利用データの準備状況を確認
  2. 02不確かなトークン数やコストを調査
  3. 03ローカルのセッションと異常を確認
  4. 04不足する価格情報やパーサーデータを修正

MCP 対応

TokenTraceはローカルstdio MCPサーバーを起動し、機能、事前確認、状態、証拠、修正キュー、レポート、明示的なスキャンのツールを提供します。起動時にスキャンは行わず、スキャンツールには`confirmLocalScan=true`が必要です。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"abhiyoheswaran1-tokentrace": {
"command": "npx",
"args": [
"-y",
"tokentrace"
]
}
}
}
起動コマンドnpx -y tokentrace

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmtokentrace0.21.2

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

TokenTrace のロゴ

TokenTrace CLI

開発者とコーディングエージェント向けの、ローカルファーストな AI CLI 利用状況分析ツールです。

TokenTrace は、次に高額な AI CLI を実行する前に、実用的な疑問に答えます。 ローカルの利用状況データは、信頼できる状態でしょうか?ローカルの Claude Code、Codex、 構造化された利用ログ、利用状況を記録するローカルデータベースをスキャンし、トークンと コストのデータに、正確、推定、不明、キャッシュ、または非キャッシュのラベルを付けます。ダッシュボードは今日の画面で開き、セッション、証拠、データ修正に直接移動できます。

TokenTrace はまずローカル開発マシン向けに設計されており、デフォルト設定は macOS を想定しています。クラウドアカウントは不要で、テレメトリやログを外部に送信することもありません。

ウェブサイト · ソース

TokenTrace の今日のダッシュボード

TokenTrace でできること

  • tokentrace preflight --json または MCP の get_preflight を使って、次のコーディングエージェントの実行前に準備状況を確認できます。
  • 今日のローカルコスト、トークン数、セッション数、信頼度、異常、修正の兆候を最初の画面でまとめて確認できます。
  • 重要な数値を、ローカルファイル、パーサーの状態、セッション、モデルの料金、信頼度ラベルまでさかのぼって確認できます。
  • プロンプトやメッセージ本文をアップロードせずに、ガイド付き修正キューで欠落したコストデータを修正できます。

数秒で開始

インストールせずに実行:

npx tokentrace

または、グローバルにインストール:

npm install -g tokentrace
tokentrace

このコマンドはローカルダッシュボードを起動し、3030 から始まる利用可能な localhost ポートを選び、デフォルトのブラウザーを開きます。Ctrl+C を押すまでサーバーは実行し続けます。

CLI コマンド:

tokentrace              # Start local dashboard
tokentrace serve        # Start local dashboard
tokentrace serve --port 3210 --no-open
                        # Start on a fixed port without opening a browser
tokentrace agent --json # Print machine-readable agent discovery manifest
tokentrace capabilities --json
                        # Alias for agent discovery manifest
tokentrace roadmap --json
                        # Print release status handoff
tokentrace mcp          # Start the local stdio MCP server
tokentrace scan         # Scan local AI CLI usage logs
tokentrace doctor --json
                        # Inspect scan health and repair recommendations
tokentrace preflight --json
                        # Check readiness before another coding-agent run
tokentrace evidence --json
                        # Print metric evidence trails as JSON
tokentrace repair --json
                        # Print unknown-cost repair groups as JSON
tokentrace digest --json
                        # Print current-month local usage digest
tokentrace digest --since yesterday
                        # Print a scoped local usage digest
tokentrace report --markdown
                        # Print a deterministic Markdown report
tokentrace review --json
                        # Print post-session scan and review movement
tokentrace insights --json
                        # Print local recommendations as JSON
tokentrace status --json
                        # Print local usage status as JSON
tokentrace statusline claude
                        # Render a Claude Code status line from stdin
tokentrace statusline claude --compact
                        # Render a shorter Claude Code status line
tokentrace statusline setup claude
                        # Print Claude Code statusLine setup JSON
tokentrace watch --session
                        # Watch local usage status in a terminal split
tokentrace watch --session --compact
                        # Watch a compact live status line
tokentrace pricing refresh
                        # Refresh public model prices
tokentrace run <cmd>    # Optional wrapper mode for command runtime diagnostics
tokentrace reset        # Reset imported local data
tokentrace reset --yes  # Reset without confirmation
tokentrace --help       # Print help
tokentrace --version    # Print version

コーディングエージェント向け

エージェントは、読み取り専用の検出マニフェストから開始してください。

tokentrace agent --json

以下のエイリアスも同じマニフェストを返します。

tokentrace capabilities --json

このマニフェストには、TokenTrace のローカルファーストなプライバシーモデル、安全な JSON コマンド、 一般的なワークフロー、Claude Code のステータスライン設定、Codex のサイドカーによるフォールバック、 および明示的な人間の承認なしに tokentrace reset を絶対に実行しないといった ガードレールが記載されています。検出コマンドは、ファイルのスキャン、データベースの初期化、 ダッシュボードの起動を行いません。

コマンドを実行する前にリポジトリや npm パッケージの内容を調べるエージェント向けに、パッケージレベルの参照資料も含まれています。

MCP 対応クライアントは、npm パッケージをインストールするか利用して、ローカルの stdio サーバーを起動できます。

tokentrace mcp

レジストリ名:io.github.abhiyoheswaran1/tokentrace。

エージェントが最初に呼び出す MCP:get_agent_guide。

ファイルをスキャンせずに、ローカル MCP エントリーポイントをセルフテストします。

tokentrace mcp selftest --json

MCP サーバーは、機能、事前チェック、ステータス、スキャンの健全性、証拠、修正キュー、レポート、明示的なスキャンツールなど、ローカルファーストな機能をツールとして提供します。起動時にファイルをスキャンすることはなく、スキャンツールでローカルの利用ファイルを読み取ったり、ローカルデータベースに書き込んだりするには、confirmLocalScan=true が必要です。

次の長時間にわたるコーディングエージェントの実行を始める前に、事前チェックを使ってください。

tokentrace preflight --json

MCP クライアントでは、get_preflight を呼び出すと、ローカルスキャンの鮮度、信頼度、ガードレール、異常、修正の検出結果に基づき、同じ続行、注意、またはブロックの判断を得られます。事前チェックはファイルをスキャンせず、生のプロンプトも調べません。

ローカルダッシュボードがすでに起動している場合、エージェントは localhost 経由で同じマニフェストを取得できます。

curl http://127.0.0.1:3030/api/agent
curl http://127.0.0.1:3030/api/capabilities

Local Sources & Trust のリリース引き継ぎ資料も、機械可読形式で提供されています。

tokentrace roadmap --json
curl http://127.0.0.1:3030/api/roadmap

ソースから実行

npm install
npm run db:migrate
npm run db:seed
npm run dev

http://localhost:3000 を開きます。

ソースから実行する際に便利なコマンド:

npm run dev          # Start the Next.js dev server
npm run build        # Build the production app
npm run start        # Serve the production build
npm run scan         # Scan default and configured folders
npm run db:migrate   # Create/update local SQLite tables
npm run db:seed      # Seed editable provider/model prices
npm run screenshots:seed
                    # Seed a guarded public-safe screenshot database
npm run reset        # Clear imported data and scan history
npm test             # Run parser and cost tests
npm run verify       # Run Vitest, TypeScript, and ESLint checks
npm run package:test # Verify, build, and dry-run the npm package
npm run package:inspect
                    # Check package transparency guardrails
npm run security:ioc
                    # Scan lockfiles, workflows, and local AI-tool hooks for supply-chain IOCs
npm run smoke:packed
                    # Inspect packed tarball and smoke test packed CLI
tokentrace roadmap --json
                    # Inspect roadmap handoff, action recipes, and release status

日々の利用サイクルと信頼性

TokenTrace は、製品を日々の利用サイクルを中心に構成するようになりました。

  1. 事前確認:次のエージェント実行の前に、ローカルの証拠が揃っているかを判断します。
  2. 今日:コスト、トークン、セッション、信頼度、異常、修復に関するシグナルを確認します。
  3. 証拠:数値を、元ファイル、パーサーの信頼度、セッション、モデル料金の状態までたどります。
  4. データ修復:不明なコスト、パーサーの確認項目、モデル料金の不足を解消します。
  5. 詳細:診断情報をすべて確認する必要がある場合は、Scan Health、Discovery、Parsers、Raw Data、Query、Model Rates を調べます。

信頼性を確保する機能には、次のものがあります。

  • ネイティブの構造化使用量ログと、Cursor 形式のチャットエクスポートの取り込み
  • Scan Health の Source Coverage で、ネイティブ、プロファイル補助、フォールバック、非対応のファイルを表示
  • JSON または Markdown 形式の、プライバシーに配慮した Evidence Pack
  • ローカルスキャンのスケジュール設定:手動、起動時、毎時、毎日
  • 警告しきい値を設定できる、プロジェクト/モデル/ツール別のガードレール
  • マッチャーを保存する前に確認できる、Import Profile のプレビュー
  • 週次使用量、ソースカバレッジ、ガードレール、不明なコスト、高コストのセッション、信頼度の推移に関する保存済みレポートのエクスポート
  • 生の使用量レコードを含まない運用メタデータのエクスポート

精度と証拠

TokenTrace は、取り込んだ数値の背後にある信頼度を示します。

  • プロバイダーから取得した正確なトークン数
  • OpenAI/Codex および Claude 系の認識済みモデル名に対するトークナイザーによる推定
  • テキスト形式のコンテンツしかない場合の簡易推定
  • ローカルの SQLite 履歴から取得した、ソース提供のコスト
  • モデル、トークン、料金の証拠が不足している場合の、不明なコストの修復グループ

ダッシュボードでは、Today、Projects、Sessions、Session Timeline の各ページにデータ信頼度スコアが表示されます。Scan Health にはサプライチェーン IOC チェックも含まれているため、パッケージの信頼性をリリーススクリプトだけでなく、製品内でも確認できます。

公開リリースにはメンテナーの承認が必要です。バージョンの更新、タグ付け、GitHub リリースの作成、npm への公開を行う前に、docs/RELEASE_CHECKLIST.md を確認してください。

ローカル開発では、SQLite データベースのデフォルトの保存先は .tokentrace/tokentrace.db です。次の設定で上書きできます。

TOKENTRACE_DB=/absolute/path/tokentrace.db npm run dev

データの保存場所

npm からインストールした場合、TokenTrace は実行時データをパッケージフォルダーの外部に保存します。

  • macOS:~/Library/Application Support/TokenTrace/
  • Linux:~/.local/share/tokentrace/
  • Windows:%APPDATA%/TokenTrace/

CLI は TOKENTRACE_DB と DATABASE_URL を自動的に設定します。次の設定でベースディレクトリを上書きできます。

TOKENTRACE_HOME=/custom/path tokentrace

TokenTrace の検索対象

デフォルトの検出では、次の場所が存在する場合に確認します。

  • ~/.claude/
  • ~/.config/claude/
  • ~/.codex/
  • ~/.config/codex/
  • ~/.openai/
  • tokentrace を実行したディレクトリにある .claude、.codex、.openai、.ai などのプロジェクトレベルの隠しフォルダー
  • ローカルのアプリデータディレクトリにある TokenTrace のラッパーログ
  • Settings で設定した任意のカスタムフォルダー

Settings でカスタムフォルダーの追加、生メッセージの保存の切り替え、スキャンの実行ができます。検出されたファイル、パーサーの判断、警告、失敗、抽出されたメタデータ、信頼度を確認するには、Scan Health、Discovery、Parsers、Raw Data を使用します。

Settings では、ローカルの月次使用量ガードレールも任意で設定できます。コスト上限、トークン上限、またはその両方を設定すると、Today に取り込まれたローカル CLI 使用量に基づく月初からの進捗が表示されます。

Sessions には、定期的な確認に使える組み込みの保存済みビューと、ローカルに保存したビューが含まれています。不明なコスト、高コストのセッション、今月の Claude/Codex、推定トークン数、ガードレールの確認、パーサーの確認などを表示できます。セッションの Timeline リンクを開くと、操作、モデルの変更、トークンの急増、キャッシュの動作、ツール呼び出し、パーサーの信頼度、不明なコストのイベントを時系列で確認できます。生のプロンプトとメッセージ本文は、デフォルトでは非表示です。

取り込みアーキテクチャ

TokenTrace の主な取り込みアーキテクチャは、ローカルファイルシステムからの直接取り込みです。

  1. ローカルの AI CLI アーティファクトを検出します。
  2. アダプターを通じて、対応形式を解析します。
  3. セッション、インタラクション、トークン使用量、モデル、プロジェクト、ツール呼び出しを正規化します。
  4. 正規化したレコードをローカルの SQLite に保存します。
  5. ローカルダッシュボードで分析結果を可視化します。

TokenTrace は、MITM プロキシ、パケットスニッフィング、ブラウザー拡張機能、トラフィックの傍受、クラウドテレメトリを使用しません。

各アダプターは互換性を検出し、可能な場合は部分的なメタデータを解析し、ファイル形式に対応していない場合は安全に処理を中止します。インポートされたインタラクションには、トークンの信頼度メタデータが付与されます。

  • exact
  • high-confidence estimate
  • low-confidence estimate
  • unknown

正確な値と推定値が、明示されずに混在することはありません。

オプションのラッパーモード

ファイルシステムからの取り込みが主な製品機能です。ラッパーモードは副次的なオプション機能です。

tokentrace run claude-code
tokentrace run codex
tokentrace run npm test

ラッパーモードはサブプロセスを起動し、実行時間を計測し、stdout/stderr のバイト数をカウントし、利用可能な場合は構造化 JSON 出力を検出して、アプリデータディレクトリにローカルの JSONL 診断ログを記録します。ネットワークトラフィックは傍受しません。

Claude Code のステータスライン

Claude Code は、ターミナル UI の下部でローカルのステータスラインコマンドを実行できます。TokenTrace は、この方法を直接サポートしています。

tokentrace statusline setup claude

出力された statusLine ブロックを ~/.claude/settings.json に追加します。これにより、Claude Code は次のコマンドを使用します。

tokentrace statusline claude

Claude Code は、stdin 経由でセッション JSON をコマンドに送信します。TokenTrace はトランスクリプトのパス、モデル、コンテキスト使用量、セッションコストを読み取り、簡潔なローカル行を 1 行出力します。

TokenTrace | Opus | ctx 7% | cost $0.1235 | processed 3.3K tokens | cache 2.0K | priced

Claude Code の statusLine.command に、単に tokentrace を指定しないでください。単なる tokentrace はダッシュボードを起動しますが、tokentrace statusline claude はステータスラインの応答を 1 つだけ出力します。

TokenTrace の Claude Code ステータスライン

Claude Code の外部でも、同じローカルステータスを確認できます。

tokentrace status --json
tokentrace watch --session

日次レポートのコマンドは、決定的かつローカルに実行されます。

tokentrace digest --since last-scan
tokentrace digest --since 2026-05-01 --json
tokentrace report --markdown --since yesterday
tokentrace review --json

Codex CLI のステータスライン連携は、脆弱なターミナル出力解析に頼らずにサポートできる程度まで、ステータスラインとフックの仕様が安定するまで意図的に保留しています。現在の代替手段として、ターミナルの分割画面または tmux ペインで tokentrace watch --session --compact を使用してください。現在の判断については、docs/CODEX_INTEGRATION_SPIKE.md を参照してください。

スクリーンショット

ダッシュボード画面:

TokenTrace の Today ダッシュボード

TokenTrace の不明なコストの根拠履歴

TokenTrace の Fix Data キュー

TokenTrace の Scan Health パーサーレビュー

CLI の起動とヘルプ:

TokenTrace CLI のヘルプ

ローカルスキャンの出力:

TokenTrace のスキャンコマンド

オプションのラッパー診断:

TokenTrace のラッパーコマンド

プライバシーモデル

  • すべての処理は、お使いのマシン上でローカルに実行されます。
  • 外部テレメトリは含まれません。Next.js のテレメトリは CLI によって無効化されます。
  • クラウドアカウントは不要です。
  • 生のプロンプトと応答の全文は、デフォルトでは保存されません。
  • TokenTrace は、デバッグと分析のコンテキスト用に短いテキストプレビューを保存します。
  • TokenTrace は、コストの推定が有用な状態に保たれるよう、公開されているモデル料金マニフェストをダウンロードする場合があります。このリクエストで、使用ログ、プロンプト、ファイルパス、分析データが送信されることはありません。バンドル済みの料金のみを使用するには、TOKENTRACE_DISABLE_PRICE_REFRESH=1 を設定してください。
  • SQLite にメッセージ本文全体をローカル保存したい場合に限り、設定で 生のメッセージ内容を保存 を有効にしてください。

tokentrace の実行中に、ターミナルで Ctrl+C を押すとサーバーを停止できます。

パッケージの信頼性

  • TokenTrace npm パッケージには、preinstall、install、postinstall スクリプトはありません。
  • 公開パッケージに含まれるのは、読み取り可能なアプリケーションソースとコンパイル済みの CLI ランタイムであり、生成された .next/server のルートバンドルではありません。
  • tokentrace serve は、必要になった初回に、ユーザーの TokenTrace アプリデータディレクトリ内でローカルダッシュボードのビルドを準備します。
  • npm run package:inspect は、生成された Next.js のビルド出力が公開 tarball に含まれている場合に失敗します。
  • npm run security:ioc は、ロックファイル、ワークフロー、ローカルの Claude/VS Code フックファイルをスキャンし、サプライチェーン侵害を示す可能性の高い兆候を検出します。
  • 公開 npm へのパブリッシュは、バージョンタグからの来歴情報と GitHub Actions の Trusted Publishing を通じて設定されています。
  • Socket の GitHub チェックと ProjScan は、npm audit --audit-level=moderate と併せて、リリースのガードレールとして使用されています。
  • npm run release:check は、ゲートコマンドがゼロ以外の終了コードを返すと失敗します。インポートグラフに循環依存がない状態を維持することが想定されています。tests/import-boundaries.test.ts は、共有の型/ヘルパーモジュールが高レベルのオーケストレーション用バレルをインポートしないよう保護します。
  • リリースノートは、リンクだけの概要としてではなく、該当する変更履歴セクションから GitHub Releases に直接公開されます。

セキュリティとプライバシーの全容については、SECURITY.md を参照してください。

モデル料金

モデルの料金は変動します。TokenTrace には、公開されている料金表が同梱されており、公開されている TokenTrace モデル料金マニフェストから更新できます。Model Rates で手動編集した内容は、以降の更新後も保持されます。

同梱のカタログには、2026年5月8日時点で確認された、OpenAI、Anthropic、Google Gemini、xAI、DeepSeek、Mistral、Cohere の一般的なモデルが含まれています。

初期データの参照元:

コスト見積もりを正確な金額として扱う前に、Model Rates で料金を確認し、更新してください。特に、バッチ処理、優先/フレックスモード、データレジデンシー、長文コンテキストの追加料金、サブスクリプション、プロバイダー固有の割引を利用する場合はご注意ください。

ダッシュボードまたは CLI から更新できます。

tokentrace pricing refresh

コストはインタラクションごとに計算されます。

inputTokens * inputPricePer1M / 1,000,000
+ outputTokens * outputPricePer1M / 1,000,000
+ cacheReadTokens * cachedInputPricePer1M / 1,000,000
+ cacheWriteTokens * cacheWritePricePer1M / 1,000,000

モデルに個別のキャッシュ料金が設定されていない場合、キャッシュ読み取りとキャッシュ書き込みの料金には入力料金が適用されます。Anthropic の初期データの行では、デフォルトで5分間のプロンプトキャッシュ書き込み料金が使用されます。行には、トークンの利用可否と料金設定に応じて、正確、推定、不明のいずれかが表示されます。

サポート対象の入力

アダプターは src/ingestion/adapters/ にあります。

  • claude-code.ts
  • codex-cli.ts
  • structured-usage-log.ts
  • cursor-chat.ts
  • sqlite-history.ts
  • generic-jsonl.ts
  • generic-json.ts
  • generic-log.ts

Claude Code と Codex CLI の形式はバージョンによって異なる場合があるため、これらのアダプターは問題に対処できるよう設計され、可能な範囲で処理します。不明なファイルは安全に失敗し、「Raw Data」ページに警告が表示されます。

サポート対象マトリクス

TokenTrace では、日々のスキャンを安心して利用できるよう、サポート範囲を明示しています。

対象サポートレベル備考
Claude Code のプロジェクトトランスクリプト安定主なローカル CLI 取り込み元です。
Codex CLI のセッションアーティファクトベストエフォートCLI の形式の変化に合わせて、慎重に解析します。
構造化された使用状況 JSONL/NDJSON安定セッション、モデル、トークン、ソースのコストフィールドを含む、ローカルラッパーやチームのログに対応します。
Cursor 形式のチャットエクスポートベストエフォートデフォルトでは生のプロンプトテキストを保存せず、ローカルのエディターチャット/コンポーザーのエクスポートをインポートします。
使用状況形式の SQLite 履歴ベストエフォートセッション、モデル、トークン、またはコストに類する列を公開するローカルデータベースを読み取ります。
汎用 JSONL、JSON、テキストログベストエフォート使用状況形式であることを確認できるレコードのみを慎重に扱います。
Claude/Codex のキャッシュ、プラグイン、ToDo、設定、サポートファイル無視解析エラーとして扱わず、使用状況データ以外のファイルとして記録します。
編集可能なモデル料金安定ローカルの料金行を使ってコストを算出し、不明なコストの修正待ちキューを管理します。
Claude Code のステータスライン安定Claude Code のドキュメントに記載された statusLine の stdin コントラクトを使用します。
Codex の固定ステータスラインベストエフォートの代替手段分割ペインまたは tmux ペインで tokentrace watch --session --compact を使用してください。
デスクトップアプリのスクレイピング、ブラウザー拡張機能、プロキシ、中継通信のキャプチャ、テレメトリー非対応TokenTrace の製品範囲外です。

パーサーの拡張

汎用 JSONL のフィクスチャ例は fixtures/generic-jsonl/ にあります。

取り込みシステムは、プラグインで拡張できるように設計されています。

  1. IngestionAdapter を実装するアダプターを追加します。
  2. src/ingestion/adapters/index.ts に登録します。
  3. tests/ にパーサーのテストを追加します。

コントリビューション

コントリビューションを歓迎します。ローカル環境のセットアップ、パーサーのガイドライン、料金の更新に関する注意事項、リリースポリシーについては、CONTRIBUTING.md をご覧ください。

トラブルシューティング

インストール中に発生する prebuild-install の非推奨警告
npm warn deprecated [email protected]: No longer maintained...

これは、TokenTrace がローカルデータの保存に使用するネイティブ SQLite ドライバーである better-sqlite3 の間接依存関係です。この警告は無害です。インストールは通常どおり完了し、TokenTrace も期待どおりに動作します。better-sqlite3 の上流が別のプリビルトバイナリーローダーに移行すれば、この警告は解消されます。TokenTrace 側で修正する必要はありません。

better-sqlite3 のネイティブビルドエラー

プリビルトバイナリーをダウンロードできない場合(オフラインのマシン、制限の厳しいプロキシ、未対応の Node ABI など)、better-sqlite3 はソースからのコンパイルを試み、失敗することがあります。次の方法をお試しください。

  • 対応している LTS 版の Node.js を使用してください(TokenTrace には >= 20.0.0 が必要です。Node 20 または 22 の LTS を推奨します)。
  • ビルドツールをインストールしてください。macOS では Xcode Command Line Tools、Linux では build-essential と python3、Windows では「C++ によるデスクトップ開発」ワークロードが必要です。
  • github.com にアクセスできるネットワーク環境でインストールを再試行し、プリビルトバイナリーを取得できるようにしてください。
EBADENGINE の警告

これらの警告は、ローカルの Node のバージョンが間接依存関係の engines フィールドで指定されたバージョンより古い場合に表示されます。エラーではなく、警告です。Node の最新の LTS にアップグレードすると解消されます。

既知の制限事項

  • Claude Code と Codex CLI のログ形式は慎重に推測しているため、実際のサンプルログを使った改善が必要になる場合があります。
  • トークナイザーを使った推定は、OpenAI/Codex および Claude 系のモデル名として認識されるものに対応しています。認識されないテキストのみのレコードでは、引き続き保守的な簡易推定が使われます。
  • SQLite 履歴の取り込みでは、使用状況形式のローカルテーブルを想定しています。セッション、モデル、トークン、またはコストに類するフィールドを公開しない任意のデータベースはスキップされます。
  • 初期設定の料金は編集可能です。アカウント、地域、プロバイダープランに応じて、手動で確認してください。

ライセンス

Abhi Yoheswaran によるオープンソースです。MIT License の下で公開されています。LICENSE をご覧ください。

今後の改善

  • より多くのローカル AI ツールとエディターの履歴に対応する、ファーストクラスのネイティブアダプターを拡充します。
  • 公開されているトークナイザーの挙動が十分に安定して明確にラベル付けできる場合は、プロバイダーごとにトークナイザーをさらに調整します。
  • 独自のラッパーログを使用するチーム向けに、インポートプロファイルのプレビューをよりインタラクティブにします。
  • 非常に大きなローカルフォルダーでは、スキャンの進行状況を UI にストリーミング表示します。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。