Cost Tracker CLI

Track AI API costs across multiple providers (Claude, OpenAI, Gemini, Kimi, etc.)

Why?

When you're using multiple AI models across different providers, costs can spiral without visibility. This CLI helps you:

• Track per-session costs — see what each conversation costs
• Monitor by model — compare Claude vs GPT vs Gemini pricing
• Export data — CSV for spreadsheets, JSON for analysis
• Stay aware — real-time cost visibility prevents bill shock

Install

npm install -g cost-tracker-cli

Or run directly with npx:

npx cost-tracker-cli report

Quick Start

# Start tracking a session
cost-tracker start

# Do your AI work...

# End session and see cost
cost-tracker end

# Check report
cost-tracker report

Usage

Commands

# Show cost report
cost-tracker report

# Start a new tracking session
cost-tracker start

# End current session
cost-tracker end

# Manually log a tool call
cost-tracker log claude 1500 420

# Export data
cost-tracker export json
cost-tracker export csv

Manual Logging

If you're not using the programmatic API, log calls manually:

cost-tracker log <model> <input_tokens> <output_tokens>

# Examples:
cost-tracker log claude-sonnet-4-6 1500 420
cost-tracker log gpt-4 2000 800
cost-tracker log gemini-flash 3000 1500

Supported Models & Pricing

Model	Input (per 1K)	Output (per 1K)
claude-sonnet-4-6	$0.003	$0.015
claude-opus-4-6	$0.015	$0.075
claude-haiku	$0.00025	$0.00125
gpt-4	$0.03	$0.06
gpt-3.5-turbo	$0.0005	$0.0015
gemini-flash	$0.0001	$0.0004
gemini-pro	$0.0035	$0.0105
kimi-k2-5	$0.0003	$0.0006

Pricing updated as of 2026-02-20. Adjust PRICING in lib/tracker.js if rates change.

Programmatic Usage

const CostTracker = require('cost-tracker-cli');

const tracker = new CostTracker();

// Start session
tracker.startSession();

// Log tool calls
tracker.recordTool('myFunction', 'claude-sonnet-4-6', 1500, 420);
tracker.recordTool('anotherCall', 'gpt-4', 2000, 800);

// End and save
tracker.endSession();

// Get report
console.log(tracker.formatReport());

Data Storage

Data is stored in ~/.cost-tracker/data.json:

• Session history
• Total costs
• Per-model breakdown
• Token counts

Example Report

📊 Cost Report
━━━━━━━━━━━━━━━━━━━━
Today: $0.0456 (3 sessions)
Total: $12.4321 (47 sessions)
Tokens: 2,230,000 in / 1,180,000 out
Current: $0.0010 (5 tools)
━━━━━━━━━━━━━━━━━━━━

By Model:
  claude-sonnet-4-6: $8.9200 (23 calls)
  kimi-k2-5: $2.8900 (19 calls)
  gemini-flash: $0.6200 (5 calls)

Export Formats

JSON

Complete data export for analysis:

{
  "totalSessions": 47,
  "totalCostUSD": 12.4321,
  "byModel": { ... },
  "sessions": [ ... ]
}

CSV

Session-level data for spreadsheets:

session_id,started,model,input_tokens,output_tokens,cost_usd
session_1771637622813,2026-02-20T09:00:00Z,claude,1500,420,0.0011

License

MIT

Contributing

Issues and PRs welcome. Focus: accurate pricing, clear reports, minimal dependencies.