[![Tokscale](./.github/assets/hero-v2.png)](https://tokscale.ai)
> 複数のプラットフォームでAIコーディングアシスタントのトークン使用量とコストを追跡するための高性能CLIツールと可視化ダッシュボード。 > [!TIP] > > **v2 リリース — ネイティブ Rust TUI、クロスプラットフォーム対応など。**
> 毎週新しいオープンソースプロジェクトを公開しています。お見逃しなく。 > > | [GitHub Follow](https://github.com/junhoyeo) | GitHubで[@junhoyeo](https://github.com/junhoyeo)をフォローして、他のプロジェクトもチェックしてください。AI、インフラ、その他様々な分野で開発しています。 | > | :-----| :----- | > [Discord link](https://discord.gg/h6DUGWdBbm) | [Discord](https://discord.gg/h6DUGWdBbm)に参加しよう — 世界最高のバイバーたちと一緒に。 |
[![GitHub Release](https://img.shields.io/github/v/release/junhoyeo/tokscale?color=0073FF&labelColor=black&logo=github&style=flat-square)](https://github.com/junhoyeo/tokscale/releases) [![npm Downloads](https://img.shields.io/npm/dt/tokscale?color=0073FF&labelColor=black&style=flat-square)](https://www.npmjs.com/package/tokscale) [![GitHub Contributors](https://img.shields.io/github/contributors/junhoyeo/tokscale?color=0073FF&labelColor=black&style=flat-square)](https://github.com/junhoyeo/tokscale/graphs/contributors) [![GitHub Forks](https://img.shields.io/github/forks/junhoyeo/tokscale?color=0073FF&labelColor=black&style=flat-square)](https://github.com/junhoyeo/tokscale/network/members) [![GitHub Stars](https://img.shields.io/github/stars/junhoyeo/tokscale?color=0073FF&labelColor=black&style=flat-square)](https://github.com/junhoyeo/tokscale/stargazers) [![GitHub Issues](https://img.shields.io/github/issues/junhoyeo/tokscale?color=0073FF&labelColor=black&style=flat-square)](https://github.com/junhoyeo/tokscale/issues) [![License](https://img.shields.io/badge/license-MIT-white?labelColor=black&style=flat-square)](https://github.com/junhoyeo/tokscale/blob/master/LICENSE) [![Coverage](https://raw.githubusercontent.com/junhoyeo/tokscale/refs/heads/main/.github/badges/coverage.svg)](https://github.com/junhoyeo/tokscale/issues/403) [🇺🇸 English](README.md) | [🇰🇷 한국어](README.ko.md) | [🇯🇵 日本語](README.ja.md) | [🇨🇳 简体中文](README.zh-cn.md)
| Overview | Models | |:---:|:---:| | ![TUI Overview](.github/assets/tui-overview.png) | ![TUI Models](.github/assets/tui-models.png) | | Daily Summary | Stats | |:---:|:---:| | ![TUI Daily Summary](.github/assets/tui-daily.png) | ![TUI Stats](.github/assets/tui-stats.png) | | Frontend (3D Contributions Graph) | Wrapped 2025 | |:---:|:---:| | Frontend (3D Contributions Graph) | Wrapped 2025 | > **[`bunx tokscale submit`](#ソーシャルプラットフォームコマンド)を実行して、使用量データをリーダーボードに送信し、公開プロフィールを作成しましょう！** ## 概要 **Tokscale**は以下のプラットフォームからのトークン消費を監視・分析するのに役立ちます： | ロゴ | クライアント | データ場所 | サポート | |------|----------|---------------|-----------| | OpenCode | [OpenCode](https://github.com/sst/opencode) | `~/.local/share/opencode/opencode.db` (1.2+、`opencode-stable.db` など全チャンネル対応) または `~/.local/share/opencode/storage/message/` | ✅ 対応 | | Claude | [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | `~/.claude/projects/` および `~/.claude/transcripts/` | ✅ 対応 | | OpenClaw | [OpenClaw](https://openclaw.ai/) | `~/.openclaw/agents/` (+ レガシー: `.clawdbot`, `.moltbot`, `.moldbot`) | ✅ 対応 | | Codex | [Codex CLI](https://github.com/openai/codex) | `~/.codex/sessions/` | ✅ 対応 | | Sakana Fugu | [Sakana Fugu](https://sakana.ai/fugu/) | Codex 経由で追跡 — `~/.codex/sessions/*.jsonl` (`model_provider: sakana`) | ✅ 対応 | | Copilot | [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/use-the-github-copilot-coding-agent-in-cli) | `~/.copilot/otel/*.jsonl` (+ `COPILOT_OTEL_FILE_EXPORTER_PATH`) | ✅ 対応 | | Hermes Agent | [Hermes Agent](https://github.com/NousResearch/hermes-agent) | `$HERMES_HOME/state.db`（フォールバック: `~/.hermes/state.db`） | ✅ 対応 | | Gemini | [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `$GEMINI_CLI_HOME/tmp/*/chats/*.json`（フォールバック: `~/.gemini/tmp/*/chats/*.json`） | ✅ 対応 | | Cursor | [Cursor IDE](https://cursor.com/) | Cursor API のエクスポートを `~/.config/tokscale/cursor-cache/usage*.csv` にキャッシュ（`~/.cursor` ではない） | ✅ 対応 | | Amp | [Amp (AmpCode)](https://ampcode.com/) | `~/.local/share/amp/threads/` | ✅ 対応 | | Codebuff | [Codebuff](https://codebuff.com/) | `~/.config/manicode/` (+ `manicode-dev`、`manicode-staging`; `CODEBUFF_DATA_DIR` でオーバーライド可能) | ✅ 対応 | | Droid | [Droid (Factory Droid)](https://factory.ai/) | `~/.factory/sessions/` | ✅ 対応 | | Pi | [Pi](https://github.com/badlogic/pi-mono) | `~/.pi/agent/sessions/` and `~/.omp/agent/sessions/` ([Oh My Pi](https://github.com/can1357/oh-my-pi)) | ✅ 対応 | | Kimi | [Kimi CLI](https://github.com/MoonshotAI/kimi-cli) / [Kimi Code](https://github.com/MoonshotAI/kimi-code) | kimi-cli: `~/.kimi/sessions/` kimi-code: `~/.kimi-code/sessions/` (`KIMI_CODE_HOME` でオーバーライド可能) | ✅ 対応 | | Qwen | [Qwen CLI](https://github.com/QwenLM/qwen-cli) | `~/.qwen/projects/` | ✅ 対応 | | Roo Code | [Roo Code](https://github.com/RooCodeInc/Roo-Code) | `~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/tasks/` (+ server: `~/.vscode-server/data/User/globalStorage/rooveterinaryinc.roo-cline/tasks/`) | ✅ 対応 | | Kilo | [Kilo](https://github.com/Kilo-Org/kilocode) | `~/.config/Code/User/globalStorage/kilocode.kilo-code/tasks/` (+ server: `~/.vscode-server/data/User/globalStorage/kilocode.kilo-code/tasks/`) | ✅ 対応 | | Kilo CLI | [Kilo CLI](https://github.com/nicepkg/kilo) | `~/.local/share/kilo/kilo.db` | ✅ 対応 | | Mux | [Mux](https://github.com/coder/mux) | `~/.mux/sessions/` | ✅ 対応 | | Crush | [Crush](https://crush.ai/) | `$XDG_DATA_HOME/crush/projects.json`（プロジェクトレジストリ。フォールバック: `~/.local/share/crush/projects.json`） | ✅ 対応 | | Goose | [Goose](https://github.com/aaif-goose/goose) | `~/.local/share/goose/sessions/sessions.db` (+ macOS Application Support、レガシー Block/goose パス; `GOOSE_PATH_ROOT` でオーバーライド可能) | ✅ 対応 | | Antigravity | [Google Antigravity](https://antigravity.google/) | `tokscale antigravity sync` で `~/.config/tokscale/antigravity-cache/sessions/*.jsonl` にキャッシュ（ローカル言語サーバ RPC を使用） | ✅ 対応 | | Antigravity CLI | [Antigravity CLI](https://antigravity.google/) | `~/.gemini/antigravity-cli/conversations/*.db`（Gemini ホームは `GEMINI_CLI_HOME` でオーバーライド可能；ローカル SQLite を直接読み取るため `antigravity sync` は不要） | ✅ 対応 | | Trae | [Trae IDE](https://www.trae.ai/) / [Trae Solo](https://www.trae.ai/solo)（国際版） | `tokscale trae sync` で `~/.config/tokscale/trae-cache/sessions/*.json` にキャッシュ（公式 API のアカウント単位使用量） | ✅ 対応 | | Warp | [Warp](https://www.warp.dev/) / Oz | `tokscale warp sync` で `~/.config/tokscale/warp-cache/usage.json` にキャッシュ（集計リクエスト数と使用金額のみ。トークントランスクリプトは含まない） | ✅ 対応 | | Grok Build | Grok Build | `$GROK_HOME/sessions/*/*/updates.jsonl`（フォールバック: `~/.grok/sessions/*/*/updates.jsonl`） | ✅ 対応 | | Zed Agent | [Zed Agent](https://zed.dev/docs/ai/agent-panel) | `~/.local/share/zed/threads/threads.db`（macOS: `~/Library/Application Support/Zed/threads/threads.db`; Windows: `%LOCALAPPDATA%/Zed/threads/threads.db`; ホスティング済み Zed モデル専用、外部 ACP エージェントは対象外） | ✅ 対応 | | Kiro | Kiro | `~/.kiro/sessions/cli/*.json`（+ `*.jsonl`）、`~/.local/share/kiro-cli/data.sqlite3`（macOS: `~/Library/Application Support/kiro-cli/data.sqlite3`）、および Kiro IDE の globalStorage スナップショット（`Kiro/User/globalStorage/kiro.kiroagent`; macOS は Application Support、Linux は `~/.config/Kiro`、Windows は `%APPDATA%\Kiro`） | ✅ 対応 | | Cline | [Cline](https://github.com/cline/cline) | VS Code globalStorage のタスクディレクトリ（Linux: `~/.config/Code/...`; macOS: `~/Library/Application Support/Code/...`; Windows: `%APPDATA%\Code\...`; サーバー: `~/.vscode-server/data/User/globalStorage/saoudrizwan.claude-dev/tasks/`） | ✅ 対応 | | Gajae-Code | [gajae-code (gjc)](https://github.com/Yeachan-Heo/gajae-code) | `~/.gjc/agent/sessions/`（`GJC_CODING_AGENT_DIR`、`GJC_CONFIG_DIR`、`PI_CONFIG_DIR` でオーバーライド可能；Linux/macOS では `$XDG_DATA_HOME/gjc/sessions/` も解決） | ✅ 対応 | | Jcode | [Jcode](https://github.com/1jehuang/jcode) | `~/.jcode/sessions/session_*.json` + `session_*.journal.jsonl` サイドカー（`JCODE_HOME` で上書き可） | ✅ 対応 | | MiMo Code | [MiMo Code](https://github.com/XiaomiMiMo/MiMo-Code) | `~/.local/share/mimocode/mimocode.db`（XDG データディレクトリ；SQLite） | ✅ 対応 | | Junie | [Junie](https://www.jetbrains.com/junie/) | `~/.junie/sessions/*/events.jsonl` | ✅ 対応 | | Command Code | [Command Code](https://github.com/CommandCodeAI/command-code) | `~/.commandcode/projects/**/*.jsonl`（トークン使用量はトランスクリプトから約4文字/トークンで推定；ディスクには永続化されない） | ✅ 対応 | | ZCode | [ZCode](https://zcode.z.ai/) | `~/.zcode/cli/db/db.sqlite`（v2 使用量データベース）および `~/.zcode/projects/**/*.jsonl`（従来の記録） | ✅ 対応 | | Synthetic | [Synthetic](https://synthetic.new/) | `hf:`モデルや`synthetic`プロバイダを検出して他ソースから再帰属（+ [Octofriend](https://github.com/synthetic-lab/octofriend): `~/.local/share/octofriend/sqlite.db`） | ✅ 対応 | [🚅 LiteLLMの価格データ](https://github.com/BerriAI/litellm)を使用してリアルタイム価格計算を提供し、階層型価格モデルとキャッシュトークン割引をサポートしています。 ### なぜ「Tokscale」？ [![Tokscale](./.github/assets/hero.png)](https://tokscale.ai) このプロジェクトは **[カルダシェフ・スケール(Kardashev Scale)](https://ja.wikipedia.org/wiki/%E3%82%AB%E3%83%AB%E3%83%80%E3%82%B7%E3%82%A7%E3%83%95%E3%83%BB%E3%82%B9%E3%82%B1%E3%83%BC%E3%83%AB)** に触発されています。これは天体物理学者ニコライ・カルダシェフがエネルギー消費量に基づいて文明の技術的発展レベルを測定するために提案した方法です。タイプI文明は惑星上で利用可能なすべてのエネルギーを活用し、タイプIIは恒星の全出力を捕捉し、タイプIIIは銀河全体のエネルギーを支配します。 AI支援開発の時代において、**トークンは新しいエネルギー**です。トークンは私たちの思考力を動かし、生産性を高め、創造的な成果を駆動します。カルダシェフ・スケールが宇宙規模でエネルギー消費を追跡するように、Tokscaleは AI増強開発のランクを上げながらトークン消費を測定します。カジュアルユーザーでも毎日数百万のトークンを消費する人でも、Tokscaleは惑星級開発者から銀河級コードアーキテクトへの旅を視覚化するのに役立ちます。 ## 目次 - [概要](#概要) - [なぜ「Tokscale」？](#なぜtokscale) - [機能](#機能) - [インストール](#インストール) - [クイックスタート](#クイックスタート) - [前提条件](#前提条件) - [開発環境セットアップ](#開発環境セットアップ) - [ネイティブモジュールのビルド](#ネイティブモジュールのビルド) - [使用方法](#使用方法) - [基本コマンド](#基本コマンド) - [TUI機能](#tui機能) - [プラットフォーム別フィルタリング](#プラットフォーム別フィルタリング) - [日付フィルタリング](#日付フィルタリング) - [価格検索](#価格検索) - [カスタム価格オーバーライド](#カスタム価格オーバーライド) - [ソーシャルプラットフォームコマンド](#ソーシャルプラットフォームコマンド) - [Cursor IDEコマンド](#cursor-ideコマンド) - [Antigravity コマンド](#antigravity-コマンド) - [Trae コマンド](#trae-コマンド) - [Warp/Oz コマンド](#warpoz-コマンド) - [タスク別レポート](#タスク別レポート) - [サブスクリプション使用量](#サブスクリプション使用量) - [出力例](#出力例--lightバージョン) - [設定](#設定) - [環境変数](#環境変数) - [フロントエンド可視化](#フロントエンド可視化) - [機能](#機能-1) - [フロントエンドの実行](#フロントエンドの実行) - [ソーシャルプラットフォーム](#ソーシャルプラットフォーム) - [機能](#機能-2) - [GitHubプロフィール埋め込みウィジェット](#githubプロフィール埋め込みウィジェット) - [GitHubプロフィールバッジ](#githubプロフィールバッジ) - [はじめに](#はじめに) - [データ検証](#データ検証) - [Wrapped 2025](#wrapped-2025) - [コマンド](#コマンド) - [含まれる内容](#含まれる内容) - [開発](#開発) - [前提条件](#前提条件-1) - [実行方法](#実行方法) - [サポートプラットフォーム](#サポートプラットフォーム) - [ネイティブモジュールターゲット](#ネイティブモジュールターゲット) - [Windowsサポート](#windowsサポート) - [セッションデータ保持](#セッションデータ保持) - [データソース](#データソース) - [価格](#価格) - [コントリビューション](#コントリビューション) - [開発ガイドライン](#開発ガイドライン) - [謝辞](#謝辞) - [ライセンス](#ライセンス) ## 機能 - **インタラクティブTUIモード** - Ratatuiによる美しいターミナルUI（デフォルトモード） - 6つのインタラクティブビュー：概要、モデル、日別、時間別、統計、エージェント（オプションの Minutely ビューを `minutelyTabEnabled` でオプトイン可能） - キーボード＆マウスナビゲーション - 9色テーマのGitHubスタイル貢献グラフ - リアルタイムフィルタリングとソート - ゼロフリッカーレンダリング - **マルチプラットフォームサポート** - OpenCode、Claude Code、Codex CLI、Copilot CLI、Cursor IDE、Gemini CLI、Amp、Codebuff、Droid、OpenClaw、Hermes Agent、Pi、Kimi CLI、Qwen CLI、Roo Code、Kilo、Mux、Kilo CLI、Crush、Goose、Antigravity、Antigravity CLI、Zed、Kiro、Trae、Warp/Oz、Cline、Gajae-Code、Grok Build、Jcode、MiMo Code、Command Code、Junie、ZCode、Synthetic全体の使用量追跡 - **リアルタイム価格** - 1時間ディスクキャッシュ付きでLiteLLMから現在の価格を取得；OpenRouter自動フォールバックと新規モデル向けCursor価格サポート - **詳細な内訳** - 入力、出力、キャッシュ読み書き、推論トークン追跡 - **ネイティブRustコア** - 10倍高速な処理のため、すべての解析と集計をRustで実行 - **Web可視化** - 2Dと3Dビューのインタラクティブ貢献グラフ - **柔軟なフィルタリング** - プラットフォーム、日付範囲、年別フィルタリング - **タスク別レポート** - マルチバックエンド対応（Apple FM、Claude、Codex、Gemini、Kiro）の LLM によるセッション要約とタスクグルーピング - **JSONエクスポート** - 外部可視化ツール用のデータ生成 - **ソーシャルプラットフォーム** - 使用量の共有、リーダーボード競争、公開プロフィール閲覧 ## インストール ### クイックスタート ```bash # npxで直接実行 npx tokscale@latest # またはbunxを使用 bunx tokscale@latest # またはエイリアスをインストールせずにDenoを使用 deno x npm:tokscale@latest # ライトモード（テーブルレンダリングのみ） npx tokscale@latest --light ``` これだけです！セットアップ不要で完全なインタラクティブTUI体験が得られます。 > **パッケージ構造**: `tokscale`は`@tokscale/cli`をインストールするエイリアスパッケージです（[`swc`](https://www.npmjs.com/package/swc)のように）。どちらもネイティブRustコア（`@tokscale/core`）を含む同じCLIをインストールします。 ### 前提条件 - [Node.js](https://nodejs.org/) または [Bun](https://bun.sh/) - （オプション）ソースからネイティブモジュールをビルドするためのRustツールチェーン ### 開発環境セットアップ ローカル開発またはソースからビルドする場合： ```bash # リポジトリをクローン git clone https://github.com/junhoyeo/tokscale.git cd tokscale # Bunをインストール（まだインストールしていない場合） curl -fsSL https://bun.sh/install | bash # 依存関係をインストール bun install # 開発モードでCLIを実行 bun run cli ``` > **注**: `bun run cli`はローカル開発用です。`bunx tokscale`でインストールすると、コマンドが直接実行されます。以下の使用法セクションはインストールされたバイナリコマンドを示しています。 ### ネイティブモジュールのビルド ネイティブRustモジュールはCLI操作に**必須**です。並列ファイルスキャンとSIMD JSON解析により約10倍高速な処理を提供します： ```bash # ネイティブコアをビルド（リポジトリルートから実行） bun run build:core ``` > **注**: `bunx tokscale@latest`でインストールすると、ネイティブバイナリはビルド済みで含まれています。ソースからのビルドはローカル開発にのみ必要です。 ## 使用方法 ### 基本コマンド ```bash # インタラクティブTUIを起動（デフォルト） tokscale # 特定のタブでTUIを起動 tokscale models # モデルタブ tokscale monthly # 日別ビュー（日別内訳を表示） tokscale hourly # 時間別タブ # レガシーCLIテーブル出力を使用 tokscale --light tokscale models --light # 明示的にTUIを起動 tokscale tui # 貢献グラフデータをJSONとしてエクスポート tokscale graph --output data.json # JSONとしてデータを出力（スクリプト/自動化用） tokscale --json # デフォルトのモデルビューをJSON形式で tokscale models --json # モデル内訳をJSON形式で tokscale monthly --json # 月別内訳をJSON形式で tokscale models --json > report.json # ファイルに保存 ``` ### TUI機能 インタラクティブTUIモードは以下を提供します： - **8つのビュー**: 概要（チャート + トップモデル）、Usage（サブスクリプションクォータ）、モデル、日別、時間別、統計（貢献グラフ）、エージェント。分単位の Minutely ビューはデフォルトで非表示で、`settings.json` の `minutelyTabEnabled` で有効化できます — [設定](#設定)を参照 - **キーボードナビゲーション**: - `←/→/Tab/BackTab`: ビュー切り替え - `↑/↓` または `Home/End`: リスト操作 - `Enter`: 日別詳細を開く（Daily タブ）/ グラフセル選択（Stats タブ） - `Esc` または `Backspace`: ダイアログを閉じる / 詳細表示を抜ける - `c/d/t`: コスト/日付/トークンでソート - `j`: 今日にジャンプ - `s`: ソース選択ダイアログを開く - `g`: グループ基準選択ダイアログを開く（モデル、クライアント+モデル、クライアント+プロバイダー+モデル、ワークスペース+モデル、セッション+モデル、クライアント+セッション+モデル） - `h`: 日別/時間別のチャート粒度を切り替え（Overview タブ） - `v`: テーブル/プロフィールビューを切り替え（Hourly タブ） - `y`: 選択行をクリップボードにコピー - `p`: 9色テーマを循環 - `r`: データを更新; `Shift+R` で自動更新の切り替え; `+`/`-` で間隔調整 - `e`: JSONにエクスポート - `q` または `Ctrl+C`: 終了 - **マウスサポート**: タブ、ボタン、フィルターをクリック - **テーマ**: Green、Halloween、Teal、Blue、Pink、Purple、Orange、Monochrome、YlGnBu - **設定の永続化**: 設定は`~/.config/tokscale/settings.json`に保存（[設定](#設定)を参照） ### グループ基準戦略 TUIで`g`を押すか、`--light`/`--json`モードで`--group-by`を使用してモデル行の集計方法を制御します： | 戦略 | フラグ | TUIデフォルト | 効果 | |------|--------|-------------|------| | **モデル** | `--group-by model` | ✅ | モデルごとに1行 — すべてのクライアントとプロバイダーを統合 | | **クライアント + モデル** | `--group-by client,model` | | クライアント-モデルペアごとに1行 | | **クライアント + プロバイダー + モデル** | `--group-by client,provider,model` | | 最も詳細 — 統合なし | | **ワークスペース + モデル** | `--group-by workspace,model` | | ローカル使用量をワークスペースキー、次にモデルでグループ化 | | **セッション + モデル** | `--group-by session,model` | | `session_id` とモデルごとに1行 — 特定のエージェント CLI セッションにコストを帰属 | | **クライアント + セッション + モデル** | `--group-by client,session,model` | | クライアント・セッション・モデルごとに1行 — `session_id` で結合するマルチエージェントランナーに便利 | **`--group-by model`**（最も統合） | クライアント | プロバイダー | モデル | コスト | |------------|------------|--------|--------| | OpenCode, Claude, Amp | github-copilot, anthropic | claude-opus-4-5 | $2,424 | | OpenCode, Claude | anthropic, github-copilot | claude-sonnet-4-5 | $1,332 | **`--group-by client,model`**（CLIデフォルト） | クライアント | プロバイダー | モデル | コスト | |------------|------------|--------|--------| | OpenCode | github-copilot, anthropic | claude-opus-4-5 | $1,368 | | Claude | anthropic | claude-opus-4-5 | $970 | **`--group-by client,provider,model`**（最も詳細） | クライアント | プロバイダー | モデル | コスト | |------------|------------|--------|--------| | OpenCode | github-copilot | claude-opus-4-5 | $1,200 | | OpenCode | anthropic | claude-opus-4-5 | $168 | | Claude | anthropic | claude-opus-4-5 | $970 | **`--group-by session,model`**（セッション単位のコスト帰属） `tokscale models --json --group-by session,model` は `(session_id, model)` ごとに1エントリを出力します。各エントリにはトップレベルの `sessionId` フィールドが含まれるため、ダウンストリームツール（例: マルチエージェント IDE）はコストデータを特定のエージェント CLI セッションに結合できます： ```json { "groupBy": "session,model", "entries": [ { "sessionId": "019e1e27-af49-7cd1-89b7-7bad1c3f3be2", "client": "codex", "provider": "openai", "model": "gpt-5", "input": 25251, "output": 47, "cacheRead": 1920, "cacheWrite": 0, "reasoning": 40, "messageCount": 12, "cost": 0.0123 } ] } ``` すべての行にクライアント名も必要な場合は `--group-by client,session,model` を使用してください（20以上の対応 CLI 全体を一度に1スポーンで処理）。 ### プラットフォーム別フィルタリング `--client`（短縮形 `-c`）でレポートを 1 つ以上のクライアントに絞り込めます。フラグは繰り返し可能で、カンマ区切りの値にも対応し、すべてのレポートコマンドで利用できます： ```bash # OpenCodeの使用量のみ表示 tokscale --client opencode # カンマ区切り：複数のクライアントを同時にフィルター tokscale --client opencode,claude # 繰り返し：同じ効果（シェルエイリアスと相性が良い） tokscale -c opencode -c claude # Cursor IDE は事前に `tokscale cursor login` が必要 tokscale --client cursor # Synthetic（synthetic.new）は他のエージェントセッションから検出されます tokscale --client synthetic # 他のフィルターと組み合わせ tokscale --client opencode,claude --week --json ``` 利用可能な値: `opencode`, `claude`, `codex`, `copilot`, `gemini`, `cursor`, `amp`, `codebuff`, `droid`, `openclaw`, `hermes`, `pi`, `kimi`, `qwen`, `roocode`, `kilocode`, `kilo`, `mux`, `crush`, `goose`, `antigravity`, `antigravity-cli`, `zed`, `kiro`, `trae`, `warp`, `cline`, `gjc`, `grok`, `jcode`, `micode`, `commandcode`, `junie`, `zcode`, `synthetic`。 > **破壊的変更 (v4.0.0)**: クライアント単位のブール型フラグ（`--opencode`、`--claude`、`--codex` など）は削除され、現在はエラーになります。代わりに正規の `--client`/`-c` フラグを使用してください — 例: `tokscale --client opencode,claude`。 ### 日付フィルタリング 日付フィルターはレポートを生成するすべてのコマンドで機能します（`tokscale`、`tokscale models`、`tokscale monthly`、`tokscale graph`）： ```bash # クイック日付ショートカット tokscale --today # 今日のみ tokscale --yesterday # 昨日のみ tokscale --week # 過去7日間 tokscale --month # 今月 # カスタム日付範囲（包括的、ローカルタイムゾーン） tokscale --since 2024-01-01 --until 2024-12-31 # 年別フィルター tokscale --year 2024 # 他のオプションと組み合わせ tokscale models --week --client claude --json tokscale monthly --month --benchmark ``` > **注**: 日付フィルターはローカルタイムゾーンを使用します。`--since`と`--until`は両方とも包括的です。 > **v2.2.0 注記**: セッションのアクティブ時間の日別バケットもローカルタイムゾーンを使用します。UTC 以外の環境では、UTC の日境界ではなくローカルのトークン/コスト日付と揃って表示される場合があります。 ### 価格検索 任意のモデルのリアルタイム価格を検索します： ```bash # モデル価格を検索 tokscale pricing "claude-3-5-sonnet-20241022" tokscale pricing "gpt-4o" tokscale pricing "grok-code" # 特定のプロバイダーソースを強制 tokscale pricing "grok-code" --provider openrouter tokscale pricing "claude-3-5-sonnet" --provider litellm # カスタム価格オーバーライドを確認 tokscale pricing list-overrides ``` **検索戦略：** 価格検索は多段階の解決戦略を使用します： 1. **カスタム価格オーバーライド** - `~/.config/tokscale/custom-pricing.json` のユーザー定義エントリの完全一致 2. **完全一致** - LiteLLM/OpenRouterデータベースでの直接検索 3. **エイリアス解決** - 親しみやすい名前を解決（例：`big-pickle` → `glm-4.7`） 4. **ティアサフィックス除去** - 品質ティアを削除（`gpt-5.2-xhigh` → `gpt-5.2`） 5. **バージョン正規化** - バージョン形式を処理（`claude-3-5-sonnet` ↔ `claude-3.5-sonnet`） 6. **プロバイダープレフィックスマッチング** - 一般的なプレフィックスを試行（`anthropic/`、`openai/`など） 7. **Cursorモデル価格** - LiteLLM/OpenRouterにまだ存在しないモデルのハードコード価格（例：`gpt-5.3-codex`） 8. **ファジーマッチング** - 部分モデル名の単語境界マッチング ### カスタム価格オーバーライド アップストリームの価格データベースがまだ正しくカバーしていないモデル ID の価格を上書きするには、Tokscale の設定ディレクトリ（デフォルトでは macOS/Linux の `~/.config/tokscale/custom-pricing.json`；`TOKSCALE_CONFIG_DIR` を設定した場合は同じく解決されるディレクトリ）に `custom-pricing.json` を作成します。 ```json { "$schema": "https://tokscale.ai/custom-pricing.schema.json", "models": { "accounts/fireworks/routers/kimi-k2p6-turbo": { "input_cost_per_million_tokens": 2.00, "output_cost_per_million_tokens": 8.00, "cache_read_input_token_cost_per_million_tokens": 0.30, "source": "https://docs.fireworks.ai/serverless/pricing", "notes": "Fireworks Kimi K2.6 Turbo (preview)" }, "accounts/fireworks/models/kimi-k2p6": { "input_cost_per_million_tokens": 0.95, "output_cost_per_million_tokens": 4.00, "cache_read_input_token_cost_per_million_tokens": 0.16 }, "kimi-k2p6-turbo": { "input_cost_per_million_tokens": 2.00, "output_cost_per_million_tokens": 8.00 } } } ``` オーバーライド価格は、ほとんどの API プロバイダーが価格を公開する方法と同じく、100万トークンあたりのドルで入力します；Tokscale は内部でこれをトークンあたりのレートに変換します。`input_cost_per_million_tokens` または `output_cost_per_million_tokens` の少なくとも一方が存在し正の値である必要があり、キャッシュ読み取り/キャッシュ作成フィールドは任意です。コピー/ペーストの互換性のため、`input_cost_per_token`、`output_cost_per_token`、`cache_read_input_token_cost` などの LiteLLM スタイルのトークンあたりフィールド名も受け付けますが、ユーザー向けには100万トークンあたりの名前を推奨します。ティアやキャッシュ価格を省略するにはフィールドを残さないでください；負の値や非有限な値は無効として扱われ、タイプミスが集計を密かに変えないようにモデルエントリ全体がスキップされます。任意の `source` および `notes` フィールドは Tokscale には無視され、自分の記録用に使用できます。 オーバーライドは完全一致のみで、大文字小文字を区別しません。Tokscale はまず生のモデル ID をチェックし、次に既存の synthetic な `/models/` 正規化、その後オーバーライドが一致しなければ LiteLLM、OpenRouter、Cursor 価格、ファジーマッチングへフォールスルーします。生の完全一致は正規化された完全一致より優先されるため、`accounts/fireworks/routers/kimi-k2p6-turbo` で特定のゲートウェイ固有モデルを上書きしつつ、`kimi-k2p6-turbo` で正規化された `/models/` パスをカバーできます。オーバーライドは起動時に一度だけ読み込まれます；ファイルを編集したらコマンドを再起動してください。これは、アップストリームの LiteLLM 価格更新を待つ間、誤ったモデル価格のバグを修正するための推奨ローカル対処法です。 **プロバイダー優先順位：** 複数のマッチがある場合、オリジナルモデル作成者がリセラーより優先されます： | 優先（オリジナル） | 非優先（リセラー） | |---------------------|-------------------------| | `xai/`（Grok） | `azure_ai/` | | `anthropic/`（Claude） | `bedrock/` | | `openai/`（GPT） | `vertex_ai/` | | `google/`（Gemini） | `together_ai/` | | `meta-llama/` | `fireworks_ai/` | 例：`grok-code`は`azure_ai/grok-code-fast-1`（$3.50/$17.50）ではなく`xai/grok-code-fast-1`（$0.20/$1.50）にマッチします。 ### ソーシャルプラットフォームコマンド ```bash # Tokscaleにログイン（GitHub認証用にブラウザを開く） tokscale login # ブラウザ認証なしで既存の Tokscale API トークンを保存 tokscale login --token tt_xxx # ログイン中のユーザーを確認 tokscale whoami # 保存済みの API トークンを QR コードとして表示（別デバイスへの共有に便利） # {"token":"tt_xxx","username":"..."} をエンコード — 任意の QR リーダーでスキャン tokscale qr # 使用量データをリーダーボードに送信 tokscale submit # 認証情報を書き込まずに CI/ヘッドレス環境で送信 # 優先順位: TOKSCALE_API_TOKEN 環境変数 > 保存済み認証情報ファイル（~/.config/tokscale/credentials.json）。 # 環境変数が設定されている場合、その実行では保存済みファイルは無視されます。 TOKSCALE_API_TOKEN=tt_xxx tokscale submit # トークンの失効: リーダーボードサイトの Settings > API Tokens # （https://tokscale.ai/settings）を開き、該当トークン行の "Revoke" をクリック。 # 失効は即座に有効になり、以降そのトークンを使ったリクエストは # HTTP 401 "Invalid API token" を返します。 # フィルター付きで送信 tokscale submit --client opencode,claude --since 2024-01-01 # 送信内容をプレビュー（ドライラン） tokscale submit --dry-run # ログアウト tokscale logout ``` CLI Submit ### Cursor IDEコマンド Cursor IDEはセッショントークンによる別途認証が必要です（ソーシャルプラットフォームのログインとは異なる）： ```bash # Cursorにログイン（ブラウザからセッショントークンが必要） # --name は任意で、後でアカウントを識別するためのラベルです tokscale cursor login --name work # Cursor認証ステータスとセッションの有効性を確認 tokscale cursor status # 保存済みのCursorアカウント一覧 tokscale cursor accounts # キャッシュされたCursor使用量を手動で更新 tokscale cursor sync --json # アクティブアカウントを切り替え（cursor-cache/usage.csvに同期されるアカウント） tokscale cursor switch work # 特定アカウントからログアウト（履歴は保持、集計から除外） tokscale cursor logout --name work # ログアウト + そのアカウントのキャッシュ削除 tokscale cursor logout --name work --purge-cache # すべてのCursorアカウントからログアウト（履歴は保持、集計から除外） tokscale cursor logout --all # 全アカウントをログアウトしてキャッシュも削除 tokscale cursor logout --all --purge-cache ``` **資格情報の保存**: Cursorアカウントは`~/.config/tokscale/cursor-credentials.json`に保存されます。使用量データは`~/.config/tokscale/cursor-cache/`にキャッシュされます（アクティブアカウントは`usage.csv`、追加アカウントは`usage..csv`）。 デフォルトでは、tokscale は **保存済みのすべての Cursor アカウントの使用量を合算**します（`cursor-cache/usage*.csv`）。後方互換のため、アクティブアカウントは `cursor-cache/usage.csv` に同期されます。 ログアウト時はキャッシュされた履歴を `cursor-cache/archive/` に移動して保持します（そのため集計には含まれません）。完全に削除したい場合は `--purge-cache` を使ってください。 **Cursorセッショントークンの取得方法:** 1. ブラウザで https://www.cursor.com/settings を開く 2. 開発者ツールを開く（F12） 3. **オプションA - Networkタブ**: ページで何らかのアクションを行い、`cursor.com/api/*`へのリクエストを見つけ、Request Headersの`Cookie`ヘッダーを確認し、`WorkosCursorSessionToken=`の後の値のみをコピー 4. **オプションB - Applicationタブ**: Application → Cookies → `https://www.cursor.com`に移動し、`WorkosCursorSessionToken`クッキーを見つけてその値をコピー（クッキー名ではなく値） > ⚠️ **セキュリティ警告**: セッショントークンはパスワードのように扱ってください。公開したり、バージョン管理にコミットしたりしないでください。トークンはCursorアカウントへの完全なアクセス権を付与します。 ### Antigravity コマンド Antigravity の同期は現在 macOS / Linux でのみサポートされています。Antigravity 対応エディタが起動していてローカル言語サーバが利用可能な場合にのみ動作し、tokscale はそのローカル言語サーバから使用量を読み取り、正規化されたアーティファクトをローカルにキャッシュします。 ```bash # 実行中の Antigravity 言語サーバを tokscale が認識できるか確認 tokscale antigravity status # ローカル Antigravity 言語サーバから使用量を tokscale のキャッシュに同期 tokscale antigravity sync # キャッシュされた Antigravity アーティファクトを削除 tokscale antigravity purge-cache ``` **キャッシュ場所**: `~/.config/tokscale/antigravity-cache/` **仕組み**: `tokscale antigravity sync` はローカルの Antigravity セッション候補を検出し、ローカル言語サーバ RPC から確定済みの使用量データを取得して、tokscale-core が後で解析できるよう正規化された JSONL アーティファクトとして保存します。最新の Antigravity データをレポートに反映したい場合は、レポート実行前に sync を実行してください。 ### Trae コマンド Trae（[ByteDance の AI IDE](https://www.trae.ai/)）には 2 つの国際版プロダクトラインがあります。使用量データはアカウント単位で共有されるため、tokscale では単一の `trae` クライアントとして表示します: - **`--variant ide`** — Trae IDE（国際版）の資格情報を使用 - **`--variant solo`** — Trae Solo（国際版）の資格情報を使用 `tokscale trae sync` は公式の `query_user_usage_group_by_session` API を呼び出し、未加工 JSON をローカルキャッシュに保存します。`--variant solo` / `--variant ide` は `login`/`logout` で資格情報の取得元を選ぶ場合にのみ使い、sync は保存済み Trae トークンで単一の `trae` レポートクライアントを更新します。 ```bash # ログイン（Trae デスクトップクライアントから資格情報を自動検出） tokscale trae login # 手動 JWT 入力（storage.json を自動検出できない環境向け） tokscale trae login --manual --variant solo # 資格情報がキャッシュされているバリアントを確認 tokscale trae status # 過去30日間の使用量を同期 tokscale trae sync --since 30 # バリアントの資格情報キャッシュを削除 tokscale trae logout --variant solo ``` **キャッシュ場所**: `~/.config/tokscale/trae-cache/` **仕組み**: tokscale はデスクトップクライアントの `iCubeAuthInfo://*` blob（`globalStorage/storage.json`）を復号して JWT を取得するか、`--manual` で貼り付けられた JWT を使用します。その後 `POST /trae/api/v1/pay/query_user_usage_group_by_session` をページングしながら呼び出し、未加工 JSON を保存します。最新の Trae データをレポートに反映したい場合は、レポート実行前に sync を実行してください。 > **中国版**: 中国版（`trae.com.cn`）は意図的に未対応です。CN バックエンドはセッション単位の使用量クエリ API を公開していません。上流で公式エンドポイントが提供された場合に追加します。 ### Warp/Oz コマンド Warp/Oz はローカルのトークントランスクリプトを公開していません。Tokscale は Warp の GraphQL API が返す集計リクエスト数と使用金額カウンターのみを同期し、トークンバケットがゼロの `warp` / `aggregate-requests` 行としてレポートします。 ```bash # 認証済み Warp リクエストからコピーした Bearer トークンまたは Cookie ヘッダーを保存 tokscale warp login # 認証情報・キャッシュの状態と診断情報を確認 tokscale warp status # 集計リクエスト数と使用金額を tokscale のローカルキャッシュに同期 tokscale warp sync # 保存済み認証情報を削除。--purge-cache を付けると同期済み使用量も削除 tokscale warp logout --purge-cache ``` **キャッシュ場所**: `~/.config/tokscale/warp-cache/usage.json` **仕組み**: `tokscale warp sync` は Warp の認証済み GraphQL API を呼び出し、アカウントおよびワークスペースの集計カウンターを取得します。Tokscale はリクエスト数をメッセージ数として、ベンダー報告の使用金額をコストとして保持しますが、リクエストを合成トークンに変換することはありません。Warp はトークン単位の使用量ではなく集計リクエストカウンターのみを持つため、公開リーダーボード向けの `submit` データからは除外されます。 ### タスク別レポート `report` コマンドは、タスク単位の使用量内訳を生成します。LLM を使って各セッションを短いタイトルとカテゴリに要約し、関連するセッションを高レベルのタスククラスタにまとめることで、トークンがどこに使われたかを俯瞰できます。 ```bash # 基本レポート（今日、デフォルトの Apple FM サマライザー） tokscale report # 過去7日間 tokscale report --week # Claude Code をサマライザーバックエンドとして使用 tokscale report --week --summarizer claude # Codex、Gemini、Kiro を使用 tokscale report --summarizer codex tokscale report --summarizer gemini tokscale report --summarizer kiro # LLM 要約をスキップ（生データのみ表示） tokscale report --no-summarize # 一から再要約（範囲内のキャッシュ済み要約をリセット） tokscale report --week --rebuild # JSON として出力 tokscale report --week --json # ワークスペースやクライアントでフィルター tokscale report --workspace my-project --client opencode ``` LLM 要約は**デフォルトで有効**になっています（`--no-summarize` でオプトアウト可能）。 **サマライザーバックエンド:** | バックエンド | コマンド | 備考 | |---------|---------|-------| | `apple-fm` | （デフォルト） | ネイティブ Rust FFI 経由のオンデバイス Apple Foundation Models（Python 不要）。ビルド済みの Apple Silicon（macOS arm64）バイナリで有効化されており、Apple Intelligence を有効にした macOS 26 以降で動作します。それ以外（Intel Mac、それ以前の macOS、Linux、Windows）では組み込みの Rust ヒューリスティックに透過的にフォールバックするため、デフォルトはすべてのプラットフォームで動作します。 | | `claude` | `claude -p` | Claude Code CLI がインストールされ認証済みである必要があります。 | | `codex` | `codex --quiet` | Codex CLI がインストールされ認証済みである必要があります。 | | `gemini` | `gemini -p` | Gemini CLI がインストールされ認証済みである必要があります。 | | `kiro` | `kiro --non-interactive` | Kiro CLI がインストールされ認証済みである必要があります。 | **仕組み:** 1. セッションがスキャンされ、プラットフォームの設定ディレクトリにあるローカルの SQLite wiki データベース（`wiki.db`）に挿入されます（Linux では `~/.config/tokscale/`、macOS では `~/Library/Application Support/tokscale/`） 2. 未要約のセッションがバッチで選択した LLM バックエンドに送られ、それぞれにタイトル・カテゴリ・説明・複雑度が返されます 3. 2 回目の LLM パスで、タイトル付けされたすべてのセッションを 3〜8 個の高レベルなタスククラスタにまとめます（例: "Kiro Auth"、"Tokscale Report"、"System Config"） 4. 結果は wiki DB にキャッシュされ、以降の実行では要約済みのセッションをスキップします **出力例:** ``` Task Group Sess Tokens Cost ─────────────────────────────────────────────────────────────────────── Tokscale Development 19 4.2B $22.66 Add task-attributed report command Implement wiki DB schema Fix pricing lookup for new models System Config 28 2.1B $10.06 Configure OpenCode workspace settings Update shell aliases Kiro Auth 4 890.5M $3.10 Implement JWT refresh flow ``` ### サブスクリプション使用量 Tokscale は AI プロバイダー横断でリアルタイムのサブスクリプションクォータを取得・表示できます。プランをどれだけ使用したか、いつ上限がリセットされるかを確認できます。 ```bash # 検出されたすべてのプロバイダーのサブスクリプション使用量を表示 tokscale usage # JSON として出力（スクリプト用） tokscale usage --json # 軽量なターミナル出力（TUI なし） tokscale usage --light ``` TUI では **Usage** タブに移動するとサブスクリプションデータを確認できます。`[Refresh]` でサブスクリプションクォータを更新できます。キーボードの更新ショートカット `r` も同じ更新パスを使用します。 > **注**: サブスクリプションのクォータと残高は**ベンダー報告**です — tokscale は各プロバイダー自身のクォータエンドポイントを呼び出し、そのレスポンスをそのまま表示します。数値はプロバイダーが報告する内容（公式ダッシュボードに表示されるものと同じ）を反映しており、tokscale 独自の使用量追跡とは独立して検証されていません。 #### 対応プロバイダー | プロバイダー | 認証方法 | メトリクス | セットアップ | |----------|-------------|---------|-------| | **Claude** | OAuth（資格情報ファイルまたは macOS Keychain） | Session（5時間）、Weekly、Opus クォータ | `claude` を実行してログイン | | **Codex**（OpenAI） | OAuth（`~/.config/codex/auth.json`、`~/.codex/auth.json`、または保存済み Tokscale アカウント） | Session、Weekly クォータ | TUI の Usage タブで `[Add Codex]` を使用するか、`codex` を実行してログイン、または `tokscale codex import --name work` で既存の認証をインポート | | **Z.ai** | API キー（環境変数） | トークン上限、Web 検索 | `ZAI_API_KEY` または `GLM_API_KEY` を設定 | | **Amp** | API キー（`~/.local/share/amp/secrets.json`） | 無料枠残高、クレジット | `amp` を実行してログイン | | **GitHub Copilot** | GitHub トークン（keychain または `~/.config/gh/hosts.yml`） | プレミアムインタラクション、チャットクォータ | `gh auth login` を実行 | | **Grok Build** | OAuth（`~/.grok/auth.json`） | クレジット、サブスクリプションプラン | `grok login` を実行 | | **Kimi** | OAuth（`~/.kimi/credentials/kimi-code.json`） | Session、Weekly クォータ | `kimi` を実行してログイン | | **MiniMax** | API キー（環境変数） | モデルごとのプロンプトクォータ | `MINIMAX_API_KEY` または `MINIMAX_API_TOKEN` を設定 | | **MiniMax Token Plan** | API キー（環境変数） | 期間 + 週間の残量パーセントクォータ（リージョン別: CN minimaxi.com + Global minimax.io） | `MINIMAX_TOKEN_PLAN_CN_KEY` および/または `MINIMAX_TOKEN_PLAN_GLOBAL_KEY` を設定 | | **Sakana**（Fugu） | セッションクッキー（環境変数またはファイル） — 課金コンソールの HTML スクレイプ、公開 API なし | 5時間、Weekly クォータウィンドウ（プランティアと月額料金をメタデータとして） | `SAKANA_SESSION_COOKIE` を設定（[docs/providers/sakana.md](docs/providers/sakana.md) を参照） | プロバイダーは自動検出されます — 有効な資格情報を持つものだけが表示されます。プロバイダーが表示されない場合は、ログイン済みか、必要な環境変数が設定されているか確認してください。 #### Codex マルチアカウント使用量 Tokscale はサブスクリプション使用量表示のために複数の Codex OAuth アカウントを保存できます。TUI の Usage タブでは、保存済みアカウントを 1 つの **Codex** セクションにまとめて表示します。アクティブなアカウントは `*` で示され、非アクティブなアカウントは `[Use]` で選択でき、アカウントの削除は `[Remove]` に続けて `[Confirm]` を使用します。 TUI を離れずにアカウントを追加するには、Usage タブで `[Add Codex]` をクリックします。Tokscale は一時的な `CODEX_HOME` で `codex login` を起動し、ログイン出力を Usage タブに表示し、生成された認証を Tokscale の保存済みアカウントストアにインポートしてから使用量を更新します。これによりログインが隔離され、現在の Codex 認証は切り替わりません。保存済みアカウントを実際の Codex 認証ファイルに書き込みたい場合は、そのアカウントの `[Use]` をクリックしてください。 スクリプトや手動でのアカウント管理のために、CLI コマンドも引き続き利用できます： ```bash # 現在の Codex 認証を名前付きの Tokscale アカウントとして保存 tokscale codex import --name work # 保存済みの Codex アカウント一覧 tokscale codex accounts tokscale codex accounts --json # アクティブな Codex アカウントを切り替えて Codex の auth.json を書き込む tokscale codex switch work # 保存済みの Codex アカウントの追跡を停止（Tokscale のストアからのみ削除 — # codex CLI 自身の auth.json/ログインには一切触れません） tokscale codex remove personal # アクティブまたは指定アカウントのサブスクリプション使用量を確認 tokscale codex status tokscale codex status --name personal --json ``` 保存済みの Codex アカウントが存在する場合、`tokscale usage --json` は各 Codex エントリの構造化されたアカウントメタデータを含み、TUI はそれらのエントリを 1 つの Codex グループにまとめて表示します。保存済みアカウントがない場合、Tokscale は現在の Codex 認証検出パス（`CODEX_HOME/auth.json`、`~/.config/codex/auth.json`、`~/.codex/auth.json`、その後 macOS Keychain）にフォールバックします。 #### 出力例 ``` ╭──────────────────────────────────────────────────────────╮ │ Session 85% left [=========---] resets in 2h 15m │ │ Weekly 72% left [========----] resets Fri 3pm │ │ Plan Max 20x │ ╰──────────────────────────────────────────────────────────╯ ╭──────────────────────────────────────────────────────────╮ │ Session 40% left [=====-------] resets in 4h 30m │ │ Weekly 90% left [==========--] resets Mon 12am │ │ Account user@example.com │ │ Plan Pro │ ╰──────────────────────────────────────────────────────────╯ ``` ### 出力例（`--light`バージョン） CLI Light ### 設定 Tokscaleは設定を`~/.config/tokscale/settings.json`に保存します： ```json { "colorPalette": "blue", "includeUnusedModels": false, "defaultClients": ["opencode", "claude"], "scanner": { "extraScanPaths": { "codex": [ "/Users/me/workspace/project-a/.codex/sessions", "/Users/me/workspace/project-b/.codex/archived_sessions" ], "hermes": [ "/Users/me/.hermes/profiles/director_planning", "/Users/me/.hermes/profiles/research/state.db" ] } } } ``` | 設定 | タイプ | デフォルト | 説明 | |---------|------|---------|-------------| | `colorPalette` | string | `"blue"` | TUIカラーテーマ（green、halloween、teal、blue、pink、purple、orange、monochrome、ylgnbu） | | `includeUnusedModels` | boolean | `false` | レポートでゼロトークンのモデルを表示 | | `autoRefreshEnabled` | boolean | `false` | TUIの自動更新を有効化 | | `autoRefreshMs` | number | `60000` | 自動更新間隔（30000-3600000ms） | | `nativeTimeoutMs` | number | `300000` | ネイティブサブプロセス処理の最大時間（5000-3600000ms） | | `defaultClients` | string[] | `[]` | `--client/-c` フラグを渡さない場合に適用されるクライアントフィルター。`--client` と同じ ID を受け付けます（例: `["opencode", "claude", "synthetic"]`）。未知の ID は無視されます。CLI フラグが指定されるとこのリストは完全に無視されます — マージはしません。 | | `light.writeCache` | boolean | `false` | `true` のとき、`tokscale --light` はレンダリング直後に TUI キャッシュを原子的に上書きします。CLI フラグ `--write-cache` / `--no-write-cache` が実行ごとに優先されます。 | | `minutelyTabEnabled` | boolean | `false` | TUI に分単位の Minutely タブを表示し、データ読み込み時に分単位の集計を実行します。分単位の粒度はほとんどのユーザーにとってニッチな診断ビューであり、大規模データセットでは分単位のバケット処理に無視できないコストがかかるため、既定では無効になっています。 | | `scanner.extraScanPaths` | object | `{}` | Tokscale のデフォルトのホームルート以外にあるセッション向けの、クライアントごとの追加スキャンルート | プロジェクトレベルの `.codex` ディレクトリ、インポートした Gemini/OpenClaw 履歴、Hermes プロファイルデータベースなど、恒久的な追加ルートには `scanner.extraScanPaths` を使用してください。Hermes のエントリは `state.db` を含むプロファイルディレクトリ、または `state.db` ファイルを直接指すことができます。Tokscale はこれらのパスを毎回デフォルトのスキャンルートとマージし、重複するルートを正規パスで重複排除します。 Minutely タブはトークン使用量を分単位で表示し、バーストパターンの診断、単一セッションのデバッグ、`autoRefreshEnabled` と組み合わせたほぼリアルタイムの監視に最も有用です。分単位の集計はデータ読み込み時にすべての解析済みメッセージを処理するため、ほとんどのユーザーには不要な RAM と CPU コストが発生します。そのため既定では非表示になっています。 有効化するには、`~/.config/tokscale/settings.json` で `minutelyTabEnabled` を `true` に設定します： ```json { "minutelyTabEnabled": true } ``` 再起動後、タブストリップの Hourly と Stats の間に Minutely タブが表示され、Tab / BackTab / Left / Right ナビゲーションがそれを循環します。フラグを `false` に戻すとタブは再び非表示になり、集計もスキップされます。 #### キャッシュディレクトリ構成 再生成可能な CLI/TUI/料金/Wrapped キャッシュは `~/.config/tokscale/cache/` 配下に保存されます（`TOKSCALE_CONFIG_DIR` を設定した場合は `${TOKSCALE_CONFIG_DIR}/cache/`）。連携同期アーティファクトは `~/.config/tokscale/antigravity-cache/` や `~/.config/tokscale/trae-cache/` など、クライアントごとのキャッシュルートに保存されます。 - `tui-data-cache.json` — TUI 起動キャッシュ - `source-message-cache.bin` + `source-message-cache.lock` — ソースメッセージキャッシュとロックファイル - `pricing-litellm.json` / `pricing-openrouter.json` — 料金キャッシュ - `opencode-migration.json` — OpenCode 移行記録 - `fonts/`、`images/` — Wrapped アセットキャッシュ このディレクトリは削除しても安全です。必要になれば Tokscale が再作成し、再生成します。 ### 環境変数 環境変数は設定ファイルの値をオーバーライドします。CI/CDや一時的な使用向け： | 変数 | デフォルト | 説明 | |----------|---------|-------------| | `TOKSCALE_NATIVE_TIMEOUT_MS` | `300000`（5分） | `nativeTimeoutMs` 設定をオーバーライド | | `TOKSCALE_API_TOKEN` | unset | 非対話的な `submit` および `delete-submitted-data` 実行用の Tokscale 個人 API トークン。Settings > API Tokens から作成するか、`tokscale login --token tt_xxx` でローカルに保存できます。 | | `TOKSCALE_EXTRA_DIRS` | unset | 一時的な追加セッションルートを `client:/abs/path,client:/abs/path` 形式で指定 | | `TOKSCALE_CONFIG_DIR` | unset | 設定ディレクトリのルート（`settings.json`、`star-cache.json`、`cache/`、`antigravity-cache/`、`trae-cache/` の保存場所）をオーバーライドします。絶対パス推奨；相対パスはプロセス CWD を基準に解決されます。CI サンドボックスや非デフォルトの場所を固定したい場合に便利です。設定されている場合、tokscale は macOS のレガシーパス（`~/Library/Application Support/tokscale/`）にフォールバックしません。 | | `TOKSCALE_FM_DEBUG` | unset | 設定すると、Apple Foundation Models の診断情報（macOS バージョンゲート、dlopen の dylib パス、ロード/シンボルエラー）を stderr に出力し、オンデバイスの apple-fm が動作した（またはしなかった）理由を説明します。 | ```bash # 例：非常に大きなデータセット用にタイムアウトを増加 TOKSCALE_NATIVE_TIMEOUT_MS=600000 tokscale graph --output data.json # 例：一時的な追加スキャンルート TOKSCALE_EXTRA_DIRS='codex:/Users/me/workspace/project-a/.codex/sessions,gemini:/Users/me/imports/imac/gemini/tmp' tokscale # 例：対話的なブラウザログインなしで CI から送信 TOKSCALE_API_TOKEN=tt_xxx tokscale submit ``` > **注**: 恒久的な追加ルートには、`~/.config/tokscale/settings.json` の `scanner.extraScanPaths` を推奨します。`TOKSCALE_EXTRA_DIRS` は一時的なオーバーライドや CI/CD に適しています。 ### ヘッドレスモード Tokscaleは、自動化、CI/CDパイプライン、バッチ処理のための**Codex CLIヘッドレス出力**からトークン使用量を集計できます。 **ヘッドレスモードとは？** Codex CLIをJSON出力フラグ付きで実行すると（例：\`codex exec --json\`）、通常のセッションディレクトリに保存する代わりに、使用量データをstdoutに出力します。ヘッドレスモードを使用すると、この使用量をキャプチャして追跡できます。 **保存場所:** \`~/.config/tokscale/headless/\` macOSでは、\`TOKSCALE_HEADLESS_DIR\`が設定されていない場合、Tokscaleは\`~/Library/Application Support/tokscale/headless/\`もスキャンします。 Tokscaleは次のディレクトリ構造を自動的にスキャンします: ``` ~/.config/tokscale/headless/ └── codex/ # Codex CLI JSONL出力 ``` **環境変数:** \`TOKSCALE_HEADLESS_DIR\`を設定してヘッドレスログディレクトリをカスタマイズできます: ```bash export TOKSCALE_HEADLESS_DIR="$HOME/my-custom-logs" ``` **推奨（自動キャプチャ）:** | ツール | コマンド例 | |--------|-----------| | **Codex CLI** | \`tokscale headless codex exec -m gpt-5 "implement feature"\` | **手動リダイレクト（オプション）:** | ツール | コマンド例 | |--------|-----------| | **Codex CLI** | \`codex exec --json "implement feature" > ~/.config/tokscale/headless/codex/ci-run.jsonl\` | **診断:** ```bash # スキャン場所とヘッドレスカウントを表示 tokscale sources tokscale sources --json ``` **CI/CD統合例:** ```bash # GitHub Actionsワークフローで - name: Run AI automation run: | mkdir -p ~/.config/tokscale/headless/codex codex exec --json "review code changes" \\ > ~/.config/tokscale/headless/codex/pr-\${{ github.event.pull_request.number }}.jsonl # 後で使用量を追跡 - name: Report token usage run: tokscale --json ``` > **注**: ヘッドレスキャプチャはCodex CLIのみサポートしています。Codexを直接実行する場合は、上記のようにstdoutをヘッドレスディレクトリにリダイレクトしてください。 ## フロントエンド可視化 フロントエンドはGitHubスタイルの貢献グラフ可視化を提供します： ### 機能 - **2Dビュー**: クラシックなGitHub貢献カレンダー - **3Dビュー**: トークン使用量に基づく高さのアイソメトリック3D貢献グラフ - **複数のカラーパレット**: GitHub、GitLab、Halloween、Winterなど - **3ウェイテーマトグル**: Light / Dark / System（OS設定に従う） - **GitHub Primerデザイン**: GitHubの公式カラーシステムを使用 - **インタラクティブツールチップ**: ホバーで詳細な日別内訳を表示 - **日別内訳パネル**: クリックでソース別、モデル別の詳細を確認 - **年別フィルタリング**: 年間を移動 - **ソースフィルタリング**: プラットフォーム別フィルター（OpenCode、Claude、Codex、Copilot、Cursor、Gemini、Amp、Codebuff、Droid、OpenClaw、Hermes Agent、Pi、Kimi、Qwen、Roo Code、Kilo、Mux、Kilo CLI、Crush、Goose、Antigravity、Antigravity CLI、Zed、Kiro、Trae、Warp、Cline、Gajae-Code、Grok Build、Jcode、MiMo Code、Command Code、Junie、ZCode、Synthetic） - **統計パネル**: 総コスト、トークン、活動日数、連続記録 - **FOUC防止**: Reactハイドレーション前にテーマを適用（フラッシュなし） ### フロントエンドの実行 ```bash cd packages/frontend bun install bun run dev ``` [http://localhost:3000](http://localhost:3000)を開いてソーシャルプラットフォームにアクセスしてください。 ## ソーシャルプラットフォーム Tokscaleには使用量データを共有し、他の開発者と競争できるソーシャルプラットフォームが含まれています。 ### 機能 - **リーダーボード** - すべてのプラットフォームで最もトークンを使用している人を確認 - **ユーザープロフィール** - 貢献グラフと統計を含む公開プロフィール - **期間フィルタリング** - 全期間、今月、今週の統計を表示 - **GitHub統合** - GitHubアカウントでログイン - **ローカルビューアー** - 送信せずにプライベートにデータを表示 ### GitHubプロフィール埋め込みウィジェット GitHubプロフィールREADMEにTokscaleの公開統計を直接埋め込むことができます： ```md [![Tokscale Stats](https://tokscale.ai/api/embed//svg)](https://tokscale.ai/u/) ``` `` を GitHub ユーザー名に置き換えてください。クエリパラメータを付けない場合は既定の `classic` カードがレンダリングされます。以下のパラメータを追加してデザインをカスタマイズできます。 | パラメータ | 値 | 効果 | | --- | --- | --- | | `template` | `classic`（デフォルト）· `minimal` · `terminal` · `graph` · `orbit` · `vitals` · `blueprint` · `receipt` | カードデザイン | | `color` | `blue` · `green` · `teal` · `purple` · `pink` · `orange` · `monochrome` · `halloween` · `YlGnBu` | アクセントカラーと貢献グラフのパレット | | `theme` | `dark`（デフォルト）· `light` | ライトまたはダークのカード | | `sort` | `tokens`（デフォルト）· `cost` | ランクを取得するリーダーボード | | `tokens`, `cost` | `compact` · `full` | 数値フォーマット、個別に設定可能 — `20.9B` か `20,941,000,000` | | `rank` | `plain`（デフォルト、`#134`）· `percent`（`top 12%`）· `total`（`#134 / 1,174`） | リーダーボードのランクの表示方法 | | `graph` | `1` で貢献グラフを追加（既定はオフ） | `classic`、`minimal`、`terminal`、`orbit`、`blueprint`、`receipt` でサポート | | `compact` | `1` でコンパクトレイアウト | `classic` のみ | 例： ```md ![](https://tokscale.ai/api/embed//svg?template=minimal&color=purple&graph=1) ![](https://tokscale.ai/api/embed//svg?template=orbit&color=pink&rank=percent) ![](https://tokscale.ai/api/embed//svg?template=terminal&color=green&theme=light) ![](https://tokscale.ai/api/embed//svg?template=receipt&color=YlGnBu&graph=1) ``` ### GitHubプロフィールバッジ shields.ioスタイルのよりコンパクトなバッジも使用できます： ```md ![Tokscale Tokens](https://tokscale.ai/api/badge//svg) ``` - ``をGitHubユーザー名に置き換えてください - オプションのクエリパラメータ： - `metric=tokens`（デフォルト）、`metric=cost`、または`metric=rank` - `style=flat`（デフォルト）または`style=flat-square` - `sort=tokens`（デフォルト）または`sort=cost` ランキング基準を制御 - `compact=1` コンパクトな数値表記を使用（例：`1.2M`、`$3.4K`） - `label=<テキスト>` 左側のラベルをカスタマイズ - `color=` 右側の背景色をカスタマイズ（例：`color=ff5733`） - 例： - `https://tokscale.ai/api/badge//svg?metric=cost&compact=1` - `https://tokscale.ai/api/badge//svg?metric=rank&sort=cost&style=flat-square` ### はじめに 1. **ログイン** - `tokscale login`を実行してGitHubで認証するか、CI/ヘッドレス用途では Settings で API トークンを作成 2. **送信** - `tokscale submit`を実行して使用量データをアップロード 3. **表示** - Webプラットフォームを訪問してプロフィールとリーダーボードを確認 ### データ検証 送信されたデータはレベル1検証を受けます： - 数学的整合性（合計が一致、負の値なし） - 未来の日付なし - 必須フィールドの存在 - 重複検出 ## Wrapped 2025 ![Wrapped 2025](.github/assets/hero-wrapped-2025.png) Spotify Wrappedにインスパイアされた、AIコーディングアシスタントの年間使用量をまとめた美しいレビュー画像を生成します。 | `bunx tokscale@latest wrapped` | `bunx tokscale@latest wrapped --clients` | `bunx tokscale@latest wrapped --agents --disable-pinned` | |:---:|:---:|:---:| | ![Wrapped 2025 (Agents + Pin Sisyphus)](.github/assets/wrapped-2025-agents.png) | ![Wrapped 2025 (Clients)](.github/assets/wrapped-2025-clients.png) | ![Wrapped 2025 (Agents + Disable Pinned)](.github/assets/wrapped-2025-agents-disable-pinned.png) | ### コマンド ```bash # 現在の年のWrapped画像を生成 tokscale wrapped # 特定の年のWrapped画像を生成 tokscale wrapped --year 2025 ``` ### 含まれる内容 生成される画像には以下が含まれます： - **総トークン数** - 年間のトークン消費量 - **トップモデル** - コスト順にランク付けされた最も使用したAIモデル3つ - **トップクライアント** - 最も使用したプラットフォーム3つ（OpenCode、Claude Code、Cursorなど） - **メッセージ数** - AIとのインタラクション総数 - **活動日数** - 少なくとも1回のAIインタラクションがあった日数 - **コスト** - LiteLLM価格に基づく推定総コスト - **連続記録** - 最長の連続活動日数 - **貢献グラフ** - 年間活動のビジュアルヒートマップ 生成されたPNGはソーシャルメディア共有に最適化されています。コミュニティとあなたのコーディングの旅を共有しましょう！ ## 開発 > **クイックセットアップ**: すぐに始めたい場合は、上記のインストールセクションの[開発環境セットアップ](#開発環境セットアップ)を参照してください。 ### 前提条件 ```bash # Bun（必須） bun --version # Rust（ネイティブモジュール用） rustc --version cargo --version ``` ### 実行方法 [開発環境セットアップ](#開発環境セットアップ)に従った後： ```bash # ネイティブモジュールをビルド（オプションだが推奨） bun run build:core # 開発モードで実行（TUIを起動） cd packages/cli && bun src/index.ts # またはレガシーCLIモードを使用 cd packages/cli && bun src/index.ts --light ```
高度な開発 ### プロジェクトスクリプト | スクリプト | 説明 | |--------|-------------| | `bun run cli` | 開発モードでCLIを実行（BunでTUI） | | `bun run build:core` | ネイティブRustモジュールをビルド（リリース） | | `bun run build:cli` | CLIのTypeScriptをdist/にビルド | | `bun run build` | coreとCLI両方をビルド | | `bun run dev:frontend` | フロントエンド開発サーバーを実行 | **パッケージ固有スクリプト**（パッケージディレクトリ内から）： - `packages/cli`: `bun run dev`、`bun run tui` - `packages/core`: `bun run build:debug`、`bun run test`、`bun run bench` **注**: このプロジェクトは開発時に**Bun**をパッケージマネージャーとして使用しています。 ### テスト ```bash # ネイティブモジュールをテスト（Rust） cd packages/core bun run test:rust # Cargoテスト bun run test # Node.js統合テスト bun run test:all # 両方 ``` ### ネイティブモジュール開発 ```bash cd packages/core # デバッグモードでビルド（コンパイルが速い） bun run build:debug # リリースモードでビルド（最適化済み） bun run build # Rustベンチマークを実行 bun run bench ``` ### グラフコマンドオプション ```bash # グラフデータをファイルにエクスポート tokscale graph --output usage-data.json # 日付フィルタリング（すべてのショートカットが使用可能） tokscale graph --today tokscale graph --week tokscale graph --since 2024-01-01 --until 2024-12-31 tokscale graph --year 2024 # プラットフォーム別フィルター tokscale graph --client opencode,claude # 処理時間ベンチマークを表示 tokscale graph --output data.json --benchmark ``` ### ベンチマークフラグ パフォーマンス分析用の処理時間を表示： ```bash tokscale --benchmark # デフォルトビューと共に処理時間を表示 tokscale models --benchmark # モデルレポートをベンチマーク tokscale monthly --benchmark # 月別レポートをベンチマーク tokscale graph --benchmark # グラフ生成をベンチマーク ``` ### フロントエンド用データの生成 ```bash # 可視化用データをエクスポート tokscale graph --output packages/frontend/public/my-data.json ``` ### パフォーマンス ネイティブRustモジュールは大幅なパフォーマンス向上を提供します： | 操作 | TypeScript | Rustネイティブ | 高速化 | |-----------|------------|-------------|---------| | ファイル探索 | ~500ms | ~50ms | **10倍** | | JSON解析 | ~800ms | ~100ms | **8倍** | | 集計 | ~200ms | ~25ms | **8倍** | | **合計** | **~1.5秒** | **~175ms** | **~8.5倍** | *約1000セッションファイル、100kメッセージのベンチマーク* #### メモリ最適化 ネイティブモジュールは以下を通じて約45%のメモリ削減も提供します： - ストリーミングJSON解析（ファイル全体のバッファリングなし） - ゼロコピー文字列処理 - マップリデュースによる効率的な並列集計 #### ベンチマークの実行 ```bash # 合成データを生成 cd packages/benchmarks && bun run generate # Rustベンチマークを実行 cd packages/core && bun run bench ```
## サポートプラットフォーム ### ネイティブモジュールターゲット | プラットフォーム | アーキテクチャ | ステータス | |----------|--------------|--------| | macOS | x86_64 | ✅ サポート | | macOS | aarch64（Apple Silicon） | ✅ サポート | | Linux | x86_64（glibc） | ✅ サポート | | Linux | aarch64（glibc） | ✅ サポート | | Linux | x86_64（musl） | ✅ サポート | | Linux | aarch64（musl） | ✅ サポート | | Windows | x86_64 | ✅ サポート | | Windows | aarch64 | ✅ サポート | Linux では、ランチャーが glibc と musl を自動検出します（`process.report`、`/lib/ld-musl-*.so.1` の musl 動的ローダー、`ldd` を使用）。検出が誤ったフレーバーを選んでしまう場合（例: 最小構成のコンテナ）は、`TOKSCALE_LIBC=musl`（または `TOKSCALE_LIBC=gnu`）を設定して強制してください。 ### Windowsサポート TokscaleはWindowsを完全にサポートしています。TUIとCLIはmacOS/Linuxと同様に動作します。 **Windowsでのインストール：** ```powershell # Bunのインストール（PowerShell） powershell -c "irm bun.sh/install.ps1 | iex" # tokscaleの実行 bunx tokscale@latest ``` #### Windowsでのデータ保存場所 AIコーディングツールはクロスプラットフォームの場所にセッションデータを保存します。ほとんどのツールはすべてのプラットフォームで同じ相対パスを使用します： | ツール | Unixパス | Windowsパス | ソース | |------|-----------|--------------|--------| | OpenCode | `~/.local/share/opencode/` | `%USERPROFILE%\.local\share\opencode\` | クロスプラットフォームの一貫性のため[`xdg-basedir`](https://github.com/sindresorhus/xdg-basedir)を使用（[ソース](https://github.com/sst/opencode/blob/main/packages/opencode/src/global/index.ts)） | | Claude Code | `~/.claude/` | `%USERPROFILE%\.claude\` | すべてのプラットフォームで同じパス | | OpenClaw | `~/.openclaw/` (+ レガシー: `.clawdbot`, `.moltbot`, `.moldbot`) | `%USERPROFILE%\.openclaw\` (+ レガシーパス) | すべてのプラットフォームで同じパス | | Codex CLI | `~/.codex/` | `%USERPROFILE%\.codex\` | `CODEX_HOME`環境変数で設定可能（[ソース](https://github.com/openai/codex)） | | Copilot CLI | `~/.copilot/otel/` | `%USERPROFILE%\.copilot\otel\` | OTELファイル書き出しが必要; `COPILOT_OTEL_FILE_EXPORTER_PATH`も自動取り込み | | Hermes Agent | `~/.hermes/` | `%USERPROFILE%\.hermes\` | `HERMES_HOME`環境変数で設定可能（[ソース](https://github.com/NousResearch/hermes-agent/blob/main/website/docs/developer-guide/session-storage.md)） | | Gemini CLI | `~/.gemini/` | `%USERPROFILE%\.gemini\` | `GEMINI_CLI_HOME`環境変数で設定可能 | | Amp | `~/.local/share/amp/` | `%USERPROFILE%\.local\share\amp\` | OpenCodeと同様に`xdg-basedir`を使用 | | Cursor | API同期 | API同期 | Cursor API から取得したデータを `usage*.csv` としてキャッシュ；ローカルの `~/.cursor` セッションデータは解析しない | | Droid | `~/.factory/` | `%USERPROFILE%\.factory\` | すべてのプラットフォームで同じパス | | Pi | `~/.pi/` and `~/.omp/` | `%USERPROFILE%\.pi\` and `%USERPROFILE%\.omp\` | すべてのプラットフォームで同じパス（Pi と [Oh My Pi](https://github.com/can1357/oh-my-pi) の両方をサポート） | | Kimi CLI | `~/.kimi/` | `%USERPROFILE%\.kimi\` | すべてのプラットフォームで同じパス | | Kimi Code | `~/.kimi-code/` | `%USERPROFILE%\.kimi-code\` | すべてのプラットフォームで同じパス | | Qwen CLI | `~/.qwen/` | `%USERPROFILE%\.qwen\` | すべてのプラットフォームで同じパス | | Roo Code | `~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/tasks/` | `%USERPROFILE%\.config\Code\User\globalStorage\rooveterinaryinc.roo-cline\tasks\` | VS Code globalStorageタスクログ | | Kilo | `~/.config/Code/User/globalStorage/kilocode.kilo-code/tasks/` | `%USERPROFILE%\.config\Code\User\globalStorage\kilocode.kilo-code\tasks\` | VS Code globalStorageタスクログ | | Cline | Linux: `~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/tasks/`; macOS: `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/tasks/`; サーバー: `~/.vscode-server/data/User/globalStorage/saoudrizwan.claude-dev/tasks/` | `%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\tasks\` | VS Code globalStorageタスクログ | | Mux | `~/.mux/sessions/` | `%USERPROFILE%\.mux\sessions\` | 全プラットフォームで同じパス | | Codebuff | `~/.config/manicode/projects/` (+ `manicode-dev`、`manicode-staging`) | `%USERPROFILE%\.config\manicode\projects\` | `CODEBUFF_DATA_DIR` 環境変数でオーバーライド | | Kilo CLI | `~/.local/share/kilo/` | `%USERPROFILE%\.local\share\kilo\` | OpenCodeと同様に`xdg-basedir`を使用 | | Crush | `$XDG_DATA_HOME/crush/`（フォールバック: `~/.local/share/crush/`） | `%USERPROFILE%\.local\share\crush\`（設定されていれば `%XDG_DATA_HOME%\crush\`） | フォールバック付きでXDGデータディレクトリを使用 | | Goose | `~/.local/share/goose/sessions/` (+ macOS Application Support、レガシー Block パス) | `%USERPROFILE%\.local\share\goose\sessions\` | `GOOSE_PATH_ROOT` 環境変数で設定可能 | | Antigravity | `~/.config/tokscale/antigravity-cache/sessions/` | — | `tokscale antigravity sync` は現在 macOS / Linux でのみサポート | | Zed Agent | `~/.local/share/zed/threads/threads.db` | `%LOCALAPPDATA%\Zed\threads\threads.db` | ホスティング済み Zed モデルの使用量のみ；外部 ACP エージェントは対象外 | | Kiro | `~/.kiro/sessions/cli/` および `~/.local/share/kiro-cli/data.sqlite3` | `%USERPROFILE%\.kiro\sessions\cli\` および `%USERPROFILE%\.local\share\kiro-cli\data.sqlite3` | Kiro セッションファイルに加え、存在する場合は Kiro CLI の SQLite データベースを解析 | | Trae | `~/.config/tokscale/trae-cache/sessions/` | `%APPDATA%\tokscale\trae-cache\sessions\` | `tokscale trae sync` で 1 回だけ同期。インストール済みの Trae IDE または Trae Solo デスクトップアプリから資格情報を自動検出 | | Warp/Oz | `~/.config/tokscale/warp-cache/usage.json` | `%APPDATA%\tokscale\warp-cache\usage.json` | `tokscale warp sync` で同期；集計リクエスト数と使用金額のみ、トークントランスクリプトは含まない | | Grok Build | `~/.grok/sessions/` | `%USERPROFILE%\.grok\sessions\` | `GROK_HOME` 環境変数で設定可能。`updates.jsonl` セッション更新を解析 | | Jcode | `~/.jcode/sessions/` | `%USERPROFILE%\.jcode\sessions\` | `JCODE_HOME` 環境変数で設定可能。`session_*.json` スナップショットと `session_*.journal.jsonl` サイドカーを解析 | | MiMo Code | `~/.local/share/mimocode/` | `%USERPROFILE%\.local\share\mimocode\` | XDG データディレクトリを使用；SQLite データベース `mimocode.db` | | Gajae-Code | `~/.gjc/agent/sessions/` | `%USERPROFILE%\.gjc\agent\sessions\` | `GJC_CODING_AGENT_DIR` で設定可能（`GJC_CONFIG_DIR`/`PI_CONFIG_DIR` も解決；Linux/macOS では `$XDG_DATA_HOME/gjc/sessions/` も対応） | | Junie | `~/.junie/sessions/` | `%USERPROFILE%\.junie\sessions\` | すべてのプラットフォームで同じホーム相対パス；`events.jsonl` 使用イベントを解析 | | ZCode | `~/.zcode/cli/db/db.sqlite` および `~/.zcode/projects/` | `%USERPROFILE%\.zcode\cli\db\db.sqlite` および `%USERPROFILE%\.zcode\projects\` | v2 SQLite モデル使用量と従来の `*.jsonl` セッショントランスクリプトを解析；Z.ai の GLM モデル向け ADE | | Synthetic | 他ソースから再帰属 | 他ソースから再帰属 | `hf:`モデル + `synthetic`プロバイダを検出 | > **注**: Windowsでは`~`は`%USERPROFILE%`に展開されます（例：`C:\Users\ユーザー名`）。これらのツールは`%APPDATA%`のようなWindowsネイティブパスではなく、クロスプラットフォームの一貫性のためにUnixスタイルのパス（`.local/share`など）を意図的に使用しています。 #### Windows固有の設定 Tokscaleは以下の場所に設定を保存します： - **TUI設定**: `%APPDATA%\tokscale\settings.json`（プラットフォームのデフォルト。`TOKSCALE_CONFIG_DIR` でオーバーライド可能） - **キャッシュ**: `%APPDATA%\tokscale\cache\`（統合キャッシュルート） - **レガシーキャッシュパス**: 以前のリリースで使われていた `%USERPROFILE%\.cache\tokscale\` のような分散パスは、新しい場所に再生成可能データが書かれるまで残ることがあります。 - **Cursor認証情報**: `%USERPROFILE%\.config\tokscale\cursor-credentials.json` - **Trae認証情報と同期済み使用量**: `%APPDATA%\tokscale\trae-cache\` - **Tokscaleアカウント認証情報**: `%USERPROFILE%\.config\tokscale\credentials.json` ## セッションデータ保持 デフォルトでは、一部のAIコーディングアシスタントは古いセッションファイルを自動的に削除します。正確な追跡のために使用履歴を保持するには、クリーンアップ期間を無効化または延長してください。 | プラットフォーム | デフォルト | 設定ファイル | 無効化設定 | ソース | |----------|---------|-------------|-------------------|--------| | Claude Code | **⚠️ 30日** | `~/.claude/settings.json` | `"cleanupPeriodDays": 9999999999` | [ドキュメント](https://docs.anthropic.com/en/docs/claude-code/settings) | | Gemini CLI | 無効 | `$GEMINI_CLI_HOME/settings.json`（フォールバック: `~/.gemini/settings.json`） | `"general.sessionRetention.enabled": false` | [ドキュメント](https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/session-management.md) | | Codex CLI | 無効 | N/A | クリーンアップ機能なし | [#6015](https://github.com/openai/codex/issues/6015) | | OpenCode | 無効 | N/A | クリーンアップ機能なし | [#4980](https://github.com/sst/opencode/issues/4980) | ### Claude Code **デフォルト**: 30日のクリーンアップ期間 `~/.claude/settings.json`に追加： ```json { "cleanupPeriodDays": 9999999999 } ``` > 非常に大きな値（例：`9999999999`日 ≈ 2700万年）を設定すると、事実上クリーンアップが無効になります。 ### Gemini CLI **デフォルト**: クリーンアップ無効（セッションは永久に保持） クリーンアップを有効にしてから無効にしたい場合は、`$GEMINI_CLI_HOME/settings.json`（フォールバック: `~/.gemini/settings.json`）で削除するか`enabled: false`に設定： ```json { "general": { "sessionRetention": { "enabled": false } } } ``` または非常に長い保持期間を設定： ```json { "general": { "sessionRetention": { "enabled": true, "maxAge": "9999999d" } } } ``` ### Codex CLI **デフォルト**: 自動クリーンアップなし（セッションは永久に保持） Codex CLIには組み込みのセッションクリーンアップがありません。`~/.codex/sessions/`のセッションは無期限に保持されます。 > **注**: これに対する機能リクエストがあります：[#6015](https://github.com/openai/codex/issues/6015) ### OpenCode **デフォルト**: 自動クリーンアップなし（セッションは永久に保持） OpenCodeには組み込みのセッションクリーンアップがありません。`~/.local/share/opencode/storage/`のセッションは無期限に保持されます。 > **注**: [#4980](https://github.com/sst/opencode/issues/4980)を参照 --- ## データソース ### OpenCode 場所: `~/.local/share/opencode/opencode.db` (v1.2+) または `storage/message/{sessionId}/*.json` (レガシー) OpenCode 1.2+はセッションをSQLiteに保存します。TokscaleはまずSQLiteから読み取り、古いバージョンの場合はレガシーJSONファイルにフォールバックします。 OpenCodeはビルド時のリリースチャンネルに応じてDBファイル名を決定します: `latest`/`beta` チャンネルは `opencode.db` を使い、それ以外のチャンネルは `opencode-.db`（例: `opencode-stable.db`、`opencode-nightly.db`）を使います。Tokscaleはこれらすべてをスキャンするため、複数のチャンネルを併用しているユーザーも統合されたビューを得られます。 各メッセージの内容： ```json { "id": "msg_xxx", "role": "assistant", "modelID": "claude-sonnet-4-20250514", "providerID": "anthropic", "tokens": { "input": 1234, "output": 567, "reasoning": 0, "cache": { "read": 890, "write": 123 } }, "time": { "created": 1699999999999 } } ``` ### Claude Code 場所: `~/.claude/projects/{projectPath}/*.jsonl` および `~/.claude/transcripts/*.jsonl` アシスタントメッセージの使用量データを含むJSONL形式： ```json {"type": "assistant", "message": {"model": "claude-sonnet-4-20250514", "usage": {"input_tokens": 1234, "output_tokens": 567, "cache_read_input_tokens": 890}}, "timestamp": "2024-01-01T00:00:00Z"} ``` `~/.claude/transcripts/` 配下のラッパートランスクリプトファイルは、実際の Claude 使用量メタデータを含む場合のみカウントされます。ユーザー/ツールイベントはあるが `usage` ブロックがないファイルは、推定せずにスキップされます。 Tokscale の `claude` クライアントは Claude Code のトークン集計であり、Claude Desktop チャットの集計ではありません。Claude Desktop は `~/Library/Application Support/Claude` などの場所にアプリデータを保存しますが、Anthropic はコンシューマー向けデスクトップチャットやチャット履歴エクスポートについて、安定したローカルのメッセージ単位トークン台帳を文書化していません。Claude Desktop のデータは存在するが Claude Code の JSONL ルートのみがスキャン可能な場合は、`tokscale clients` を実行すると診断が表示されます。`tokscale usage` は Claude Code の認証情報からベストエフォートで Claude サブスクリプションのクォータバーを表示できますが、組織/API 使用量は Anthropic の Admin Usage and Cost API に属し、ローカルのトランスクリプトスキャンとは意図的に分離されています。 ### Codex CLI 場所: `~/.codex/sessions/*.jsonl` `token_count`イベントを含むイベントベース形式： ```json {"type": "event_msg", "payload": {"type": "token_count", "info": {"last_token_usage": {"input_tokens": 1234, "output_tokens": 567}}}} ``` ### Copilot CLI 場所: `~/.copilot/otel/*.jsonl` または `COPILOT_OTEL_FILE_EXPORTER_PATH` に明示されたパス Copilot対応はファイル書き出しされたOpenTelemetry JSONLを読み取ります。Copilotを実行する前に有効化してください: ```bash export COPILOT_OTEL_ENABLED=true export COPILOT_OTEL_EXPORTER_TYPE=file mkdir -p "$HOME/.copilot/otel" export COPILOT_OTEL_FILE_EXPORTER_PATH="$HOME/.copilot/otel/copilot-otel-$(date +%Y%m%d-%H%M%S).jsonl" ``` PowerShell: ```powershell $otelDir = "$HOME/.copilot/otel" New-Item -ItemType Directory -Force -Path $otelDir | Out-Null $env:COPILOT_OTEL_ENABLED = "true" $env:COPILOT_OTEL_EXPORTER_TYPE = "file" $env:COPILOT_OTEL_FILE_EXPORTER_PATH = Join-Path $otelDir ("copilot-otel-{0}.jsonl" -f (Get-Date -Format "yyyyMMdd-HHmmss")) ``` タイムスタンプ付きのファイル名を使用することを推奨します。これにより、各Copilotセッションが1つの巨大なOTELログに蓄積されるのではなく、新しいファイルに書き込まれます。 Tokscaleは `chat` spanをトークン集計の信頼源として扱い、ツールspanおよび累積メトリクスはフェーズ1で無視します: ```json {"type":"span","name":"chat gpt-5.4-mini","attributes":{"gen_ai.operation.name":"chat","gen_ai.response.model":"gpt-5.4-mini","gen_ai.conversation.id":"session-id","gen_ai.usage.input_tokens":1234,"gen_ai.usage.output_tokens":567,"gen_ai.usage.cache_read.input_tokens":890,"gen_ai.usage.reasoning.output_tokens":123}} ``` > CopilotのOTELペイロードは現在、安定したワークスペースメタデータを公開していないため、Copilotの行はワークスペース属性なしで表示される場合があります。Tokscaleは可能な限り報告されたモデルからこれらの行を価格計算し、`github.copilot.cost` を直接信頼しません。 ### Gemini CLI 場所: `$GEMINI_CLI_HOME/tmp/{projectHash}/chats/*.json`（フォールバック: `~/.gemini/tmp/{projectHash}/chats/*.json`） メッセージ配列を含むセッションファイル: ```json { "sessionId": "xxx", "messages": [ {"type": "gemini", "model": "gemini-2.5-pro", "tokens": {"input": 1234, "output": 567, "cached": 890, "thoughts": 123}} ] } ``` ### Cursor IDE 場所: `~/.config/tokscale/cursor-cache/`（Cursor API経由で同期） CursorデータはセッショントークンでCursor APIから取得され、ローカルにキャッシュされます。認証するには`tokscale cursor login`を実行してください。セットアップ手順は[Cursor IDEコマンド](#cursor-ideコマンド)を参照。 ### Antigravity 場所: `~/.config/tokscale/antigravity-cache/sessions/*.jsonl`（ローカルの Antigravity 言語サーバ RPC 経由で同期） Antigravity データはルートコマンドでは自動取得されません。Antigravity 対応エディタを開いた状態で `tokscale antigravity sync` を実行してローカルキャッシュを更新し、その後はキャッシュ済みの JSONL アーティファクトに対して通常の tokscale レポートとフィルターを利用してください。 ### Trae 場所: `~/.config/tokscale/trae-cache/sessions/*.json`（公式使用量 API 経由で同期） Trae データはルートコマンドでは自動取得されません。最初に `tokscale trae login` を実行し、レポート前に `tokscale trae sync` または `tokscale trae sync --since 30` を実行してください。Tokscale は同期された API dump をセッション単位のレコードとして解析し、Trae が返すコスト合計を保持します。 ### Grok Build 場所: `$GROK_HOME/sessions/*/*/updates.jsonl`（フォールバック: `~/.grok/sessions/*/*/updates.jsonl`） Grok Build データはローカルのセッション更新から直接解析されます。現在のログは安定した input/output 分割なしで累積 `totalTokens` カウンターを公開するため、Tokscale はターンごとの正の増分を input トークンとして記録します。`grok-composer-2.5-fast` は専用の公開価格が利用可能になるまで Composer 2.5 Fast 価格 override に一時的にマップされます。 ### Jcode 場所: `$JCODE_HOME/sessions/session_*.json`（フォールバック: `~/.jcode/sessions/session_*.json`）と、対応する `session_*.journal.jsonl` サイドカー。 Jcode データはローカルのセッションスナップショットから直接解析されます。Tokscale は別のクライアントの識別子を偽装することなく、アシスタントの `messages[].token_usage` フィールド（`input_tokens`、`output_tokens`、`cache_read_input_tokens`、`cache_creation_input_tokens`、`reasoning_output_tokens`）を読み取ります。対応するジャーナルサイドカーは重複排除の前に同じセッションストリームへマージされるため、Jcode がスナップショットにチェックポイントするまでの間も、最近追記されたメッセージが含まれます。リプレイの重複排除には安定したメッセージ ID を使用し、ID を持たない不正/カスタムなレコードにはスコープ付きのフォールバックキーを使用します。 ### OpenClaw 場所: `~/.openclaw/agents/*/sessions/sessions.json`（レガシーパスもスキャン: `~/.clawdbot/`, `~/.moltbot/`, `~/.moldbot/`） JSONLセッションファイルを指すインデックスファイル: ```json { "agent:main:main": { "sessionId": "uuid", "sessionFile": "/path/to/session.jsonl" } } ``` model_changeイベントとアシスタントメッセージを含むセッションJSONL形式: ```json {"type":"model_change","provider":"openai-codex","modelId":"gpt-5.2"} {"type":"message","message":{"role":"assistant","usage":{"input":1660,"output":55,"cacheRead":108928,"cost":{"total":0.02}},"timestamp":1769753935279}} ``` ### Hermes Agent 場所: `$HERMES_HOME/state.db`（フォールバック: `~/.hermes/state.db`） HermesはSQLiteの`sessions`テーブルにセッションレベルの使用量を保存します。Tokscaleは`model`が存在しトークンまたはコスト合計が0でない行をインポートし、`started_at`をタイムスタンプとして使用し、`message_count`を保持し、`actual_cost_usd`を`estimated_cost_usd`より優先します。 ### Pi 場所: `~/.pi/agent/sessions//*.jsonl` および `~/.omp/agent/sessions//*.jsonl`（[Oh My Pi](https://github.com/can1357/oh-my-pi)） セッションヘッダーとメッセージエントリを含むJSONL形式： ```json {"type":"session","id":"pi_ses_001","timestamp":"2026-01-01T00:00:00.000Z","cwd":"/tmp"} {"type":"message","id":"msg_001","timestamp":"2026-01-01T00:00:01.000Z","message":{"role":"assistant","model":"claude-3-5-sonnet","provider":"anthropic","usage":{"input":100,"output":50,"cacheRead":10,"cacheWrite":5,"totalTokens":165}}} ``` ### Kimi CLI 場所: `~/.kimi/sessions/{GROUP_ID}/{SESSION_UUID}/wire.jsonl` StatusUpdate メッセージを含む wire.jsonl 形式： ```json {"type": "metadata", "protocol_version": "1.3"} {"timestamp": 1770983426.420942, "message": {"type": "StatusUpdate", "payload": {"token_usage": {"input_other": 1562, "output": 2463, "input_cache_read": 0, "input_cache_creation": 0}, "message_id": "chatcmpl-xxx"}}} ``` ### Kimi Code 場所: `~/.kimi-code/sessions/{WORKDIR}/{SESSION_UUID}/agents/{AGENT}/wire.jsonl` ```json {"type":"usage.record","model":"kimi-code/kimi-for-coding","usage":{"inputOther":1163,"output":352,"inputCacheRead":22272,"inputCacheCreation":0},"usageScope":"turn","time":1780410897480} ``` ### Qwen CLI 場所: `~/.qwen/projects/{PROJECT_PATH}/chats/{CHAT_ID}.jsonl` 形式: JSONL — 1行に1つのJSONオブジェクト、各オブジェクトに`type`、`model`、`timestamp`、`sessionId`、`usageMetadata`フィールドを含む。 トークンフィールド（`usageMetadata`から）: - `promptTokenCount` → 入力トークン - `candidatesTokenCount` → 出力トークン - `thoughtsTokenCount` → 推論/思考トークン - `cachedContentTokenCount` → キャッシュされた入力トークン ### Roo Code 場所： - ローカル：`~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/tasks/{TASK_ID}/ui_messages.json` - サーバー（ベストエフォート）：`~/.vscode-server/data/User/globalStorage/rooveterinaryinc.roo-cline/tasks/{TASK_ID}/ui_messages.json` 各タスクディレクトリには、モデル/エージェントメタデータに使用される``ブロックを含む`api_conversation_history.json`も含まれる場合があります。 `ui_messages.json`はUIイベントの配列です。Tokscaleは以下のみをカウントします： - `type == "say"` - `say == "api_req_started"` `text`フィールドはトークン/コストメタデータを含むJSONです： ```json { "type": "say", "say": "api_req_started", "ts": "2026-02-18T12:00:00Z", "text": "{\"cost\":0.12,\"tokensIn\":100,\"tokensOut\":50,\"cacheReads\":20,\"cacheWrites\":5,\"apiProtocol\":\"anthropic\"}" } ``` ### Kilo 場所： - ローカル：`~/.config/Code/User/globalStorage/kilocode.kilo-code/tasks/{TASK_ID}/ui_messages.json` - サーバー（ベストエフォート）：`~/.vscode-server/data/User/globalStorage/kilocode.kilo-code/tasks/{TASK_ID}/ui_messages.json` KiloはRoo Codeと同じタスクログ形式を使用します。Tokscaleは同じルールを適用します： - `ui_messages.json`から`say/api_req_started`イベントのみをカウント - `text` JSONから`tokensIn`、`tokensOut`、`cacheReads`、`cacheWrites`、`cost`、`apiProtocol`を解析 - 利用可能な場合、隣接する`api_conversation_history.json`からモデル/エージェントメタデータを補完 ### Cline 場所: - Linux デスクトップ VS Code: `~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/tasks/{TASK_ID}/ui_messages.json` - macOS デスクトップ VS Code: `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/tasks/{TASK_ID}/ui_messages.json` - Windows デスクトップ VS Code: `%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\tasks\{TASK_ID}\ui_messages.json` - サーバー（ベストエフォート）: `~/.vscode-server/data/User/globalStorage/saoudrizwan.claude-dev/tasks/{TASK_ID}/ui_messages.json` Cline は Roo Code と Kilo がフォークした元となるアップストリームプロジェクトであり、同じ VS Code globalStorage のタスクログ形式を使用します。Tokscale は同じルールを適用します： - `ui_messages.json`から`say/api_req_started`イベントのみをカウント - `text` JSONから`tokensIn`、`tokensOut`、`cacheReads`、`cacheWrites`、`cost`、`apiProtocol`を解析 - 利用可能な場合、隣接する`api_conversation_history.json`からモデル/エージェントメタデータを補完 ### Mux 場所: `~/.mux/sessions/{WORKSPACE_ID}/session-usage.json` Muxはセッションごとの累積トークン使用量を`session-usage.json`ファイルに保存します。各ファイルにはモデルごとのトークン内訳を含む`byModel`マップがあります: `input`、`cached`（キャッシュ読み取り）、`cacheCreate`（キャッシュ書き込み）、`output`、`reasoning` モデル名は`provider:model`形式を使用します（例: `anthropic:claude-opus-4-6`）— tokscaleはモデル識別のためにプロバイダプレフィクスを除去します サブエージェントの使用量はMuxによって自動的に親セッションにロールアップされるため、二重計上はありません ### Kilo CLI 場所: `~/.local/share/kilo/kilo.db` Kilo CLIはOpenCodeと同様のSQLiteデータベースにセッションデータを保存します。各メッセージ行には、モデルおよびプロバイダー属性とともにメッセージごとのトークン内訳（入力、出力、キャッシュ読み取り/書き込み、推論）が含まれます。 ### Crush 場所: `$XDG_DATA_HOME/crush/projects.json`を通じて発見されるプロジェクトごとのSQLiteデータベース（フォールバック: `~/.local/share/crush/projects.json`） Crushはプロジェクトごとのデータベース（`crush.db`）に使用量を保存します。Crushは信頼できるメッセージごとまたはモデルごとのトークン集計を提供しないため、Tokscaleはルートセッションのセッションレベルのコスト合計のみをインポートします。レコードは`model=session-total`として表示され、トークン内訳はゼロです。 ### Goose 場所: `~/.local/share/goose/sessions/sessions.db`（`~/Library/Application Support/goose/`、`~/Library/Application Support/Block/goose/`、`~/.local/share/Block/goose/` もスキャン; `GOOSE_PATH_ROOT` でオーバーライド可能） Goose はセッションごとの使用量を SQLite の `sessions.db` に保存します。Tokscale は `model_config_json` からモデル、`provider_name` からプロバイダ、そしてセッションごとに累積された入力/出力トークン合計を抽出します。推論トークンはそのカラムが値を持つ場合に推定されます。 ### Codebuff 場所: `~/.config/manicode/projects//chats//chat-messages.json`（`manicode-dev` および `manicode-staging` チャネルもスキャン; `CODEBUFF_DATA_DIR` でオーバーライド可能） Codebuff（旧 Manicode）はチャットごとに JSON ファイルを書き出します。Tokscale は `metadata.usage`、`metadata.codebuff.usage`、および run-state の `messageHistory[*].providerOptions` フォールバックからトークン使用量を解析し、部分的に新しいエントリが実トークン数を持つ古いエントリを覆い隠さないように履歴を逆順に走査します。メッセージごとのタイムスタンプが欠けている場合は chat-id ディレクトリ名、最後にファイルの mtime にフォールバックします。 ### Gajae-Code (gjc) 場所: `~/.gjc/agent/sessions//*.jsonl`（エージェントディレクトリは `GJC_CODING_AGENT_DIR` でオーバーライド可能；`GJC_CONFIG_DIR`/`PI_CONFIG_DIR` に `agent/sessions` を結合した形式も解決；Linux/macOS では `$XDG_DATA_HOME/gjc/sessions/` へのフラットなリダイレクトにも対応）。深さ2のサブエージェントトランスクリプト（`//N-*.jsonl`）も検出します。 セッションヘッダーとメッセージエントリを含む JSONL 形式。Tokscale はアシスタントメッセージのみを対象とし、存在する場合は gjc の信頼性の高いメッセージごとの `usage.cost.total`（USD）を再利用し、ない場合のみトークンから再計算します： ```json {"type":"session","id":"S1","timestamp":"2026-01-01T00:00:00.000Z","cwd":"/work/proj"} {"type":"message","id":"M1","timestamp":"2026-01-01T00:00:01.000Z","message":{"role":"assistant","model":"claude-sonnet-4","provider":"anthropic","usage":{"input":1000,"output":500,"cacheRead":0,"cacheWrite":0,"totalTokens":1500,"cost":{"input":0.1,"output":0.2,"total":0.3}}}} ``` メッセージは `:`（確定的なフォールバック付き）で重複排除されるため、深さ1/深さ2のトランスクリプトが再生されても1回だけカウントされます。`service_tier_change` および不正な行は行単位でスキップされます。 ### Synthetic (synthetic.new) Synthetic は他ソースのメッセージを後処理で再帰属します。`hf:`プレフィックスのモデル ID または `synthetic` / `glhf` / `octofriend` プロバイダを検出した場合、ソースを `synthetic` として扱います。 また `~/.local/share/octofriend/sqlite.db` を検出し、トークン情報を持つレコードを取り込みます。 ### MiMo Code 場所: `~/.local/share/mimocode/mimocode.db`（XDG データディレクトリ） MiMo Code は SQLite データベースにセッションデータを保存します。Tokscale はワークスペースコンテキストのために `session` テーブルと結合した `message` テーブルをクエリします： ```sql SELECT m.id, m.session_id, m.data, NULLIF(s.directory, '') AS workspace_root FROM message m LEFT JOIN session s ON s.id = m.session_id WHERE json_extract(m.data, '$.role') = 'assistant' AND json_extract(m.data, '$.tokens') IS NOT NULL ``` `data` カラムは JSON 形式で、以下のトークン関連フィールドを含みます： ```json { "role": "assistant", "modelID": "claude-sonnet-4", "providerID": "anthropic", "cost": 0.0032, "tokens": { "input": 1200, "output": 450, "reasoning": 0, "cache": { "read": 800, "write": 0 } }, "time": { "created": 1780410897000, "completed": 1780410912000 }, "agent": "micode", "path": { "root": "/Users/me/project" } } ``` Tokscale はタイムスタンプ、モデル、プロバイダ、トークン数、コスト、エージェント名のフィンガープリントを使用して、フォークされたセッション間のメッセージを重複排除します。 ## 価格 Tokscaleは[LiteLLMの価格データベース](https://github.com/BerriAI/litellm/blob/main/model_prices_and_context_window.json)からリアルタイム価格を取得します。 **ダイナミックフォールバック**: LiteLLMにまだ存在しないモデル（例：最近リリースされたモデル）は、[OpenRouterのエンドポイントAPI](https://openrouter.ai/docs/api/api-reference/endpoints/list-endpoints)から自動的に価格を取得します。 **Cursorモデル価格**: LiteLLMとOpenRouterの両方にまだ存在しない最新モデル（例：`gpt-5.3-codex`）は、[Cursorモデルドキュメント](https://cursor.com/en-US/docs/models)から取得したハードコード価格を使用します。これらのオーバーライドはすべてのアップストリームソースの後、ファジーマッチングの前にチェックされるため、実際のアップストリーム価格が利用可能になると自動的に優先されます。 **Sakana Fugu価格**: Fugu UltraのコストはSakanaが公開している従量課金（pay-as-you-go）レートから推定します。`fugu`ルーターモデルは、実際にオーケストレーションした基盤モデルの変動レートがそのままコストになるため、意図的に価格を設定していません。 **キャッシュ**: 価格データは1時間TTLでディスクにキャッシュされ、高速な起動を確保します： - LiteLLMキャッシュ: `~/.config/tokscale/cache/pricing-litellm.json` - OpenRouterキャッシュ: `~/.config/tokscale/cache/pricing-openrouter.json`（サポート対象プロバイダーのモデル作成者価格をキャッシュ） 価格には以下が含まれます： - 入力トークン - 出力トークン - キャッシュ読み取りトークン（割引） - キャッシュ書き込みトークン - 推論トークン（o1などのモデル用） - モデル固有の階層型価格（例: 200k または 272k トークン以上） ## コントリビューション コントリビューションを歓迎します！以下の手順に従ってください： 1. リポジトリをフォーク 2. 機能ブランチを作成（`git checkout -b feature/amazing-feature`） 3. 変更を加える 4. テストを実行（`cd packages/core && bun run test:all`） 5. 変更をコミット（`git commit -m 'Add amazing feature'`） 6. ブランチにプッシュ（`git push origin feature/amazing-feature`） 7. プルリクエストを開く ### 開発ガイドライン - 既存のコードスタイルに従う - 新機能にはテストを追加 - 必要に応じてドキュメントを更新 - コミットは集中的かつアトミックに ## 謝辞 - インスピレーションを与えてくれた[ccusage](https://github.com/ryoppippi/ccusage)、[viberank](https://github.com/sculptdotfun/viberank)、[Isometric Contributions](https://github.com/jasonlong/isometric-contributions) - ターミナルUIフレームワーク[Ratatui](https://github.com/ratatui/ratatui) - リアクティブレンダリングの[Solid.js](https://www.solidjs.com/) - 価格データの[LiteLLM](https://github.com/BerriAI/litellm) - Rust/Node.jsバインディングの[napi-rs](https://napi.rs/) - 2Dグラフ参照の[github-contributions-canvas](https://github.com/sallar/github-contributions-canvas) ## ライセンス

MIT © Junho Yeo

このプロジェクトが興味深いと感じたら、**スターを付けてください ⭐** または[GitHubでフォロー](https://github.com/junhoyeo)して旅に参加してください（すでに1.1k以上が乗船中）。私は24時間コーディングし、定期的に驚くべきものを出荷しています—あなたのサポートは無駄になりません。