Beeper Token Time Tracker

Pulls your Claude Code token usage and costs from local JSONL files (using ccusage) and pushes them to tokentime.beeper-tools.com API for web analytics. Heavily inspired and built on top of ccusage.

Installation

npm install -g @bi/beeper-tokentime-tracker

Or use directly with npx:

npx @bi/beeper-tokentime-tracker <userId> [--test]

Usage

Production Mode

beeper-tokentime-tracker <userId>

This will fetch your Claude Code usage data and send it to the Token Time API endpoint. You can get your userId from tokentime.beeper-tools.com.

Test Mode

beeper-tokentime-tracker <userId> --test

In test mode, the tool will send data to http://localhost:3000/api instead of the production API.

VS Code Extension

This package includes a VS Code extension that automatically syncs your usage data every 15 minutes. To use it:

1. Navigate to the extension/ folder in this package
2. Copy the folder to your VS Code extensions directory, or
3. Use vsce package to create a .vsix file and install it manually

What it does

1. Fetches your Claude Code usage data using ccusage
2. Parses the daily usage statistics
3. Sends the data to an API endpoint with the following format:

{
  "userId": "your-user-id",
  "data": {
    "daily": [
      // Daily usage data from ccusage
    ]
  }
}

Requirements

• Node.js 14 or higher
• Claude Code must be installed and configured

License

MIT