Skip to content
TakoAPI
Back to skills

tokenmeter

by cheenu1092-oss

Coding Agents & IDEs
1.2kDownloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Track AI token usage and costs across providers.

Description

What This Skill Does

Tracks LLM token usage and calculates API-equivalent costs, storing all data locally in SQLite at ~/.tokenmeter/usage.db. Session files from OpenClaw and Claude Code are parsed to produce per-model cost breakdowns, including prompt cache read and write tokens. Shows how much a flat-rate subscription like Claude Max saves compared to pay-as-you-go API billing.

It accounts for prompt cache read and write tokens separately, which most cost calculators ignore, giving a more accurate API-equivalent spend figure.

When to Use It

  • Checking how much you spent on Claude this week
  • Comparing Claude Max plan value against API billing costs
  • Finding which models account for the largest share of spending
  • Monitoring daily token usage across multiple agent instances
  • Month-end billing reconciliation before the billing cycle closes

Example Workflow

INPUT

User asks: how much did we spend this week?

AGENT
  1. 1

    Checks if tokenmeter is installed at ~/clawd/tokenmeter, clones and sets up the Python venv if missing

  2. 2

    Activates the venv and runs tokenmeter import --auto to pull in latest session files

  3. 3

    Runs tokenmeter costs --period week to get a per-model cost breakdown

  4. 4

    Parses output to extract totals and per-model percentages

  5. 5

    Responds with a plain-English summary including Max plan savings estimate

OUTPUT

Weekly API-equivalent cost broken down by model, with savings compared to the flat subscription cost

Installation

clawhub install cheenu1092-oss/tokenmeter

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links