tokscale

🇺🇸 English | 🇰🇷 한국어 | 🇯🇵 日本語 | 🇨🇳 简体中文

| Overview | Models | |:---:|:---:| | | |

| Daily Summary | Stats | |:---:|:---:| | | |

| Frontend (3D Contributions Graph) | Wrapped 2025 | |:---:|:---:| | | |

Run bunx tokscale@latest submit to submit your usage data to the leaderboard and create your public profile!

Overview

Tokscale helps you monitor and analyze your token consumption from:

| Logo | Client | Data Location | Supported | |------|----------|---------------|-----------| | | OpenCode | ~/.local/share/opencode/opencode.db (1.2+, all channels including opencode-stable.db) or/and ~/.local/share/opencode/storage/message/ (legacy/unmigrated) | ✅ Yes | | | Claude Code | ~/.claude/projects/ | ✅ Yes | | | OpenClaw | ~/.openclaw/agents/ (+ legacy: .clawdbot, .moltbot, .moldbot) | ✅ Yes | | | Codex CLI | ~/.codex/sessions/ | ✅ Yes | | | Hermes Agent | $HERMES_HOME/state.db (fallback: ~/.hermes/state.db) | ✅ Yes | | | Gemini CLI | ~/.gemini/tmp/*/chats/*.json | ✅ Yes | | | Cursor IDE | API sync via ~/.config/tokscale/cursor-cache/ | ✅ Yes | | | Amp (AmpCode) | ~/.local/share/amp/threads/ | ✅ Yes | | | Droid (Factory Droid) | ~/.factory/sessions/ | ✅ Yes | | | Pi | ~/.pi/agent/sessions/ and ~/.omp/agent/sessions/ (Oh My Pi) | ✅ Yes | | | Kimi CLI | ~/.kimi/sessions/ | ✅ Yes | | | Qwen CLI | ~/.qwen/projects/ | ✅ Yes | | | Roo Code | ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/tasks/ (+ server: ~/.vscode-server/data/User/globalStorage/rooveterinaryinc.roo-cline/tasks/) | ✅ Yes | | | Kilo | ~/.config/Code/User/globalStorage/kilocode.kilo-code/tasks/ (+ server: ~/.vscode-server/data/User/globalStorage/kilocode.kilo-code/tasks/) | ✅ Yes | | | Mux | ~/.mux/sessions/ | ✅ Yes | | | Kilo CLI | ~/.local/share/kilo/kilo.db | ✅ Yes | | | Crush | $XDG_DATA_HOME/crush/projects.json (project registry; fallback: ~/.local/share/crush/projects.json) | ✅ Yes | | | Synthetic | Re-attributed from other sources via hf: model prefix or synthetic provider (+ Octofriend: ~/.local/share/octofriend/sqlite.db) | ✅ Yes |

Get real-time pricing calculations using 🚅 LiteLLM's pricing data, with support for tiered pricing models and cache token discounts.

Why "Tokscale"?

This project is inspired by the Kardashev scale, a method proposed by astrophysicist Nikolai Kardashev to measure a civilization's level of technological advancement based on its energy consumption. A Type I civilization harnesses all energy available on its planet, Type II captures the entire output of its star, and Type III commands the energy of an entire galaxy.

In the age of AI-assisted development, tokens are the new energy. They power our reasoning, fuel our productivity, and drive our creative output. Just as the Kardashev scale tracks energy consumption at cosmic scales, Tokscale measures your token consumption as you scale the ranks of AI-augmented development. Whether you're a casual user or burning through millions of tokens daily, Tokscale helps you visualize your journey up the scale—from planetary developer to galactic code architect.

Contents

• Overview
  • Why "Tokscale"?
• Features
• Installation
  • Quick Start
  • Prerequisites
  • Development Setup
  • Building the Native Module
• Usage
  • Basic Commands
  • TUI Features
  • Filtering by Platform
  • Date Filtering
  • Pricing Lookup
  • Social
  • Cursor IDE Commands
  • Example Output
  • Configuration
  • Environment Variables
• Frontend Visualization
  • Features
  • Running the Frontend
• Social Platform
  • Features
  • Getting Started
  • Data Validation
• Wrapped 2025
  • Command
  • What's Included
• Development
  • Prerequisites
  • How to Run
• Supported Platforms
  • Native Module Targets
  • Windows Support
• Session Data Retention
• Data Sources
• Pricing
• Contributing
  • Development Guidelines
• Acknowledgments
• License