tkm

orbit CLI を使った Token Manager（tkm）

Claude Code のセッション全体にわたる AI トークンの消費量、コスト、使用傾向を追跡します。データは Claude Code のセッション JSONL ファイルから自動的に取り込まれ、ローカルの SQLite データベースに保存されます。

前提条件

1. orbit CLI がインストールされていること — which orbit が失敗する場合は、次の方法でインストールしてください。
   • macOS/Linux（Homebrew）： brew install jorgemuza/tap/orbit
   • macOS/Linux（スクリプト）： curl -sSfL https://raw.githubusercontent.com/jorgemuza/orbit/main/install.sh | sh
   • Windows（Scoop）： scoop bucket add jorgemuza https://github.com/jorgemuza/scoop-bucket && scoop install orbit
2. Claude Code がインストールされ、使用されていること（セッションファイルは ~/.claude/projects/ にあります）

プロファイルやサービスの設定は不要です。tkm はローカルデータのみで動作します。

クイックリファレンス

# Today's token usage and cost
orbit tkm status

# This week's summary
orbit tkm status --period week

# Daily usage breakdown
orbit tkm usage

# Weekly usage
orbit tkm usage --period weekly

# Monthly usage
orbit tkm usage --period monthly

# Cost breakdown by model
orbit tkm cost

# This calendar month so far (matches latest row of 'tkm usage --period monthly')
orbit tkm cost --period month

# Trailing 30 days (straddles month boundaries)
orbit tkm cost --period month-rolling

# Recent sessions with token counts
orbit tkm sessions

# More sessions
orbit tkm sessions --limit 50

# Filter by project
orbit tkm status --project /path/to/project
orbit tkm usage --project /path/to/project

# Filter by model
orbit tkm usage --model opus

# Force sync session data
orbit tkm sync

# Full re-sync (re-process all files)
orbit tkm sync --full

# JSON output for scripting
orbit tkm status -o json
orbit tkm cost -o json

# Manually record a usage event
orbit tkm track --model claude-opus-4-6 --input 1000 --output 500

# Clear all tracking data
orbit tkm clear --confirm

主なワークフロー

1日の支出を確認する

orbit tkm status
orbit tkm cost --period today

週ごとのコストを確認する

orbit tkm usage --period weekly --limit 8
orbit tkm cost --period week

プロジェクトごとに分析する

# Check spending on a specific project
orbit tkm status --period month --project /Users/me/Projects/my-app
orbit tkm sessions --project /Users/me/Projects/my-app

モデルのコストを比較する

orbit tkm cost --period month

レポート用にデータをエクスポートする

orbit tkm usage --period monthly -o json > monthly-usage.json
orbit tkm cost -o json > cost-breakdown.json
orbit tkm sessions -o json > sessions.json

期間の意味

--period では、today、yesterday、week（過去 7 日間）、month（当月の開始日から現在まで。例：2026-04-01 → 現在）、month-rolling（月の境界をまたぐ直近 30 日間）、all を指定できます。「今月のこれまでの支出」を確認し、tkm usage --period monthly の最新行と一致させたい場合は month を使用してください。直近 30 日間の期間を確認したい場合は month-rolling を使用してください。

データの保存先

• データベース： ~/.config/orbit/tkm.db（SQLite）
• ソース： ~/.claude/projects/<encoded-path>/<session-id>.jsonl
• 自動同期： 読み取りコマンド（status、usage、cost、sessions）の実行ごとに自動で同期されます
• 差分処理： 前回の同期以降に追加された新しいデータのみを解析します（バイトオフセットを追跡）
• 保持期間： 90 日より古いファイルはスキップします

Draxarp へのデータ送信

トークン使用量データを Draxarp Tracking に送信して、一元的に分析できます。

# Push unpushed events to Draxarp
orbit -p paybook tracking tkm push

# Preview without pushing
orbit -p paybook tracking tkm push --dry-run

# Push with larger batch
orbit -p paybook tracking tkm push --batch-size 500

差分同期を使用し、まだ送信されていないイベントのみを送信します。再実行しても安全です（Draxarp はイベントハッシュで重複を排除します）。

RTK との連携（任意）

RTK は、コマンドの出力が LLM に届く前に圧縮する補助ツールで、入力トークンを 60～90％削減します。orbit tkm は分析を担当します。

ツール	役割
RTK	コマンドの出力（git、grep、npm など）を圧縮します
orbit tkm	使用量を追跡し、コストを計算して、傾向をレポートします

RTK は任意です。tkm は単独で動作します。RTK の圧縮を追加するには、次のようにします。

# Install RTK
brew install rtk-ai/tap/rtk

# Set up Claude Code hooks
rtk init -g

# Verify compression is working
rtk verify

モデルの料金

デフォルト料金（100 万トークンあたり）：

モデル	入力	出力	キャッシュ読み取り	キャッシュ書き込み
claude-opus-4-6	$15.00	$75.00	$1.50	$18.75
claude-sonnet-4-6	$3.00	$15.00	$0.30	$3.75
claude-haiku-4-5	$0.80	$4.00	$0.08	$1.00

コマンドとフラグの詳細については、references/commands.md を参照してください。