mcpField
T
tkm

tkm

github.com/jorgemuza数据与数据库061 次安装今天更新
代码仓库

关于 tkm

tkm 是 orbit CLI 中用于跟踪 Claude Code 会话的 Token 用量、成本和趋势的工作流。它将本地会话 JSONL 数据导入 SQLite，并按时间段或项目生成报告，支持 JSON 导出。

主要功能

  1. 01跟踪 Token 用量、成本与趋势
  2. 02导入 Claude Code 会话文件
  3. 03将数据存入本地 SQLite
  4. 04按时间段或项目生成报告
  5. 05以 JSON 导出报告

适用场景

  1. 01查看每日或每周 Token 支出
  2. 02分析某个项目的用量
  3. 03比较模型成本
  4. 04导出用量数据用于报告

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jorgemuza/orbit --skill tkm

安装后在 Claude Code 中输入/tkm确认已加载。

附带文件references/commands.md

详细介绍

使用 orbit CLI 的 Token Manager（tkm）

跟踪 Claude Code 会话中的 AI Token 消耗、费用和使用趋势。数据会从 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

核心工作流

查看每日支出
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

Token 使用数据可以推送到 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 是一个配套工具，可在命令输出到达大模型之前对其进行压缩，从而节省 60-90% 的输入 Token。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

模型定价

默认定价（每百万 Token）：

模型输入输出缓存读取缓存写入
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。

评论

支持 Markdown