MIT ライセンスのローカル優先トークン/コスト分析ダッシュボード。DeepSeek Harness のローカルセッションデータにネイティブ互換し、ヒートマップ・コスト追跡・クオータ監視を提供します。
DSH 統合
互換
作者による申告
安全性監査
未監査
最終検証日
2026-08-29
ライセンス
MIT
01どんなタスクに使えるのか？
各 AI コーディングツールのトークン使用量とコストを一つのローカルダッシュボードで追跡・分析する
ローカル Web ダッシュボード上のヒートマップ・正確なトークン内訳・コスト集計・クオータリセットのカウントダウン、および任意のメニューバー常駐アプリ
DeepSeek Harness・Claude Code・Codex・Kimi などのエージェントを動かし、トークンやコストの支出をローカルで把握したい開発者やチーム
サブスクリプションのクオータウィンドウとリセットのカウントダウンを監視する
ローカルログまたは opt-in のライブポーリングに基づく、サブスクリプションウィンドウとリセットタイマーを備えたクオータタブ
Codex・Claude Code・Antigravity などの従量制・サブスクリプション計画を利用し、クオータ上限への到達を避けたいユーザー
02DeepSeek Harness への導入方法
前提条件
- Python **3.10+**
- One or more [supported clients](docs/reference/SUPPORTED_CLIENTS.md) installed
インストール手順
- 01
pipx install tokdash
- 02
python3 -m pip install --user tokdash
- 03
tokdash setup
- 04
tokdash setup --auto --json
- 05
tokdash setup --dry-run
導入成功の確認
- tokdash doctor
- tokdash doctor --json
ロールバック
- tokdash uninstall
03DSH 統合と能力の範囲
$DSH_HOME/sessions から DeepSeek Harness（dsh）のセッションをローカルに読み取り、API キー不要で localhost のみアクセス可能。DSH のデータ構造に互換
正確なトークン計数
エージェントのセッションログ（ローカルファイル）→入力 / 出力 / キャッシュのトークン内訳
コントリビューションカレンダー
過去の利用記録→Tokens / Cost / Messages を指標とする 2D ヒートマップ + 3D 等角ビュー
クオータタブ
ローカルのセッションログ、または opt-in のライブクオータポーリング→Codex・Claude Code・Antigravity のサブスクリプションウィンドウとリセット倒计时
有効化したライブポーリングは、本機の CLI 認証情報を使って各プロバイダー自身のクオータ API を呼び出すステータスライン連携
ローカル HTTP エンドポイント（Tokdash API）→Claude Code のステータスライン、またはローカルエンドポイントにアクセスできる任意のエージェント向けのライブ token 用量インジケーター
コンパニオン・ステータスバーアプリ
設定済みの Tokdash エンドポイント→macOS メニューバーまたは Windows 通知領域での利用額・サブスクリプションクオータ表示
コンパニオンは設定した Tokdash エンドポイントのみに接続する
04誰に向いているのか？使うべきでない場面は？
向いている用途
- DeepSeek Harness・Claude Code・Codex・Kimi などのエージェントを動かし、トークンやコストの支出をローカルで把握したい開発者やチーム
- Codex・Claude Code・Antigravity などの従量制・サブスクリプション計画を利用し、クオータ上限への到達を避けたいユーザー
不向きな用途
- オプションのクオータポーリングは、各プロバイダー自身のクオータ API を呼び出すために本機の CLI 認証情報のみを使用し、応答をローカルの usage SQLite DB に保存します。既定ではオフで、プロバイダーごとの同意が必要です。
05互換性・メンテナンス・セキュリティ上の注意
- Tokdash は既定でループバックのみにバインドされ、ダッシュボードとローカル API は読み取り専用で localhost 限定であり、Tokdash が動作していない場合は静かに失敗します。
- オプションのクオータポーリングは、各プロバイダー自身のクオータ API を呼び出すために本機の CLI 認証情報のみを使用し、応答をローカルの usage SQLite DB に保存します。既定ではオフで、プロバイダーごとの同意が必要です。
- コストは既定で内蔵の料金データベースから計算され、プロバイダーの実際の価格より遅れることがあります。見積もりとして扱い、重要な場合は課金明細で確認してください。
- macOS はサポート対象です。Windows ネイティブ版は実験的です。
MIT · 活発にメンテナンス中（最新リリース v2.4.0、2026-08-28）
06よくある質問
Tokdash は DeepSeek Harness とどう連携しますか？
ローカルの $DSH_HOME/sessions（既定 ~/.dsh）から DSH のセッションを直接読み取り、API キーや通信は不要です。各 zstd ログフレームをデコードし、フォークしたセッションの継承プレフィックスをスキップしてトークンの二重計上を防ぎます。
Tokdash はネットワーク接続が必要ですか？
いいえ。既定ではすべて localhost で動作し、ローカルのログファイルのみを読みます。通信が発生するのは、ライブクオータポーリングを opt-in で有効にした場合だけで、その際も既存の CLI 認証情報を使って各プロバイダー自身のクオータ API のみを呼び出します。
どうやってインストールと検証をしますか？
`pipx install tokdash`（または `python3 -m pip install --user tokdash`）でインストールし、`tokdash setup` で初期設定を行い、その後 `tokdash doctor` でランタイム・サービス・ポート・データパスを確認します。
コストの数値は正確ですか？
トークン数は各クライアントのローカルログに基づき、コストは内蔵の料金データベースから計算されるため、プロバイダーの実際の価格より遅れることがあります。見積もりとして扱い、重要な場合は課金明細で確認してください。
Tokdash を削除するには？
`tokdash uninstall` を実行すると、setup が作成した内容を正確に取り消します。既定では利用履歴を保持し、`--purge` を付けると履歴も削除します。
07関連する DSH ワークフロー
dsh-cost-meter
by han-1413141
セッション/日次 API コスト、予算使用率、公式残高、履歴ダッシュボード、公式価格ワンクリック同期（ピーク/オフピーク）
dsh-usage-stats
by ychris12138
DSH Web GUI 向けトークンヒートマップ、モデル別内訳、DeepSeek 残高
dsh-balance-meter
by ghost011118
DSH Web GUI に DeepSeek 残高とセッションコスト表示
dsh-token-usage
by laoyuehanni
リクエストごとのモデルのトークン使用量を日別 JSONL ファイルに記録し、Web 設定の統計ページで日次推移グラフ・モデル別内訳・日付/モデル絞り込みを表示
08データと出典
DeepSeek Harness (`dsh`) usage and sessions are read locally from `$DSH_HOME/sessions/*/*/session.jsonl.zstd` (or the un…
| DeepSeek Harness | ✅ | ✅ |
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日：2026-08-29。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。