Vibe Coding Tracker — AI Coding Assistant Usage Tracker

Track your AI coding costs in real-time. Vibe Coding Tracker is a powerful CLI tool that helps you monitor and analyze your Claude Code and Codex usage, providing detailed cost breakdowns, token statistics, and code operation insights.

English | 繁體中文 | 简体中文

🎯 Why Vibe Coding Tracker?

💰 Know Your Costs

Stop wondering how much your AI coding sessions cost. Get real-time cost tracking with automatic pricing updates from LiteLLM.

📊 Beautiful Visualizations

Choose your preferred view:

Interactive Dashboard: Auto-refreshing terminal UI with live updates
Static Reports: Professional tables for documentation
Script-Friendly: Plain text and JSON for automation
Full Precision: Export exact costs for accounting

🚀 Zero Configuration

Automatically detects and processes logs from both Claude Code and Codex. No setup required—just run and analyze.

🎨 Rich Insights

Token usage by model and date
Cost breakdown by cache types
File operations tracking
Command execution history
Git repository information

✨ Key Features

Feature	Description
🤖 Auto-Detection	Intelligently identifies Claude Code or Codex logs
💵 Smart Pricing	Fuzzy model matching + daily cache for speed
🎨 4 Display Modes	Interactive, Table, Text, and JSON outputs
📈 Comprehensive Stats	Tokens, costs, file ops, and tool calls
⚡ High Performance	Built with Rust for speed and reliability
🔄 Live Updates	Real-time dashboard refreshes every second
💾 Efficient Caching	Smart daily cache reduces API calls

🚀 Quick Start

Installation

Prerequisites: Rust toolchain (1.70+)

# Clone and build
git clone https://github.com/Mai0313/VibeCodingTracker.git
cd VibeCodingTracker
cargo build --release

# Binary locations:
# - ./target/release/vibe_coding_tracker (full name)
# - ./target/release/vct (short alias)

First Run

# View your usage with interactive dashboard (using short alias)
./target/release/vct usage

# Or use the full name
./target/release/vct usage

# Analyze a specific conversation
./target/release/vct analysis --path ~/.claude/projects/session.jsonl

💡 Tip: Use vct as a short alias for vibe_coding_tracker to save typing!

📖 Command Guide

🔍 Quick Reference

vct <COMMAND> [OPTIONS]

Commands:
  usage       Show token usage and costs (default: interactive)
  analysis    Analyze conversation files and export data
  version     Display version information
  help        Show help information

💰 Usage Command

Track your spending across all AI coding sessions.

Basic Usage

# Interactive dashboard (recommended)
vct usage

# Static table for reports
vct usage --table

# Plain text for scripts
vct usage --text

# JSON for data processing
vct usage --json

What You Get

The tool scans these directories automatically:

~/.claude/projects/*.jsonl (Claude Code)
~/.codex/sessions/*.jsonl (Codex)

🎨 Interactive Mode (Default)

Live dashboard that updates every second

┌──────────────────────────────────────────────────────────────────┐
│                  📊 Token Usage Statistics                       │
└──────────────────────────────────────────────────────────────────┘
┌────────────┬──────────────────────┬────────────┬────────────┬────────────┬──────────────┬────────────┬────────────┐
│ Date       │ Model                │ Input      │ Output     │ Cache Read │ Cache Create │ Total      │ Cost (USD) │
├────────────┼──────────────────────┼────────────┼────────────┼────────────┼──────────────┼────────────┼────────────┤
│ 2025-10-01 │ claude-sonnet-4-20…  │ 45,230     │ 12,450     │ 230,500    │ 50,000       │ 338,180    │ $2.15      │
│ 2025-10-02 │ claude-sonnet-4-20…  │ 32,100     │ 8,920      │ 180,000    │ 30,000       │ 251,020    │ $1.58      │
│ 2025-10-03 │ claude-sonnet-4-20…  │ 28,500     │ 7,200      │ 150,000    │ 25,000       │ 210,700    │ $1.32      │
│ 2025-10-03 │ gpt-4-turbo          │ 15,000     │ 5,000      │ 0          │ 0            │ 20,000     │ $0.25      │
│            │ TOTAL                │ 120,830    │ 33,570     │ 560,500    │ 105,000      │ 819,900    │ $5.30      │
└────────────┴──────────────────────┴────────────┴────────────┴────────────┴──────────────┴────────────┴────────────┘
┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ 💰 Total Cost: $5.30  |  🔢 Total Tokens: 819,900  |  📅 Entries: 4  |  🧠 Memory: 12.5 MB                       │
└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

Press 'q', 'Esc', or 'Ctrl+C' to quit

Features:

✨ Auto-refreshes every second
🎯 Highlights today's entries
🔄 Shows recently updated rows
💾 Displays memory usage
📊 Summary statistics

Controls: Press q, Esc, or Ctrl+C to exit

📋 Static Table Mode

Perfect for documentation and reports

vct usage --table

📊 Token Usage Statistics

╔════════════╦══════════════════════╦════════════╦════════════╦════════════╦══════════════╦══════════════╦════════════╗
║ Date       ║ Model                ║ Input      ║ Output     ║ Cache Read ║ Cache Create ║ Total Tokens ║ Cost (USD) ║
╠════════════╬══════════════════════╬════════════╬════════════╬════════════╬══════════════╬══════════════╬════════════╣
║ 2025-10-01 ║ claude-sonnet-4-20…  ║ 45,230     ║ 12,450     ║ 230,500    ║ 50,000       ║ 338,180      ║ $2.15      ║
║ 2025-10-02 ║ claude-sonnet-4-20…  ║ 32,100     ║ 8,920      ║ 180,000    ║ 30,000       ║ 251,020      ║ $1.58      ║
║ 2025-10-03 ║ claude-sonnet-4-20…  ║ 28,500     ║ 7,200      ║ 150,000    ║ 25,000       ║ 210,700      ║ $1.32      ║
║            ║ TOTAL                ║ 105,830    ║ 28,570     ║ 560,500    ║ 105,000      ║ 799,900      ║ $5.05      ║
╚════════════╩══════════════════════╩════════════╩════════════╩════════════╩══════════════╩══════════════╩════════════╝

📝 Text Mode

Ideal for scripting and parsing

vct usage --text

2025-10-01 > claude-sonnet-4-20250514: $2.154230
2025-10-02 > claude-sonnet-4-20250514: $1.583450
2025-10-03 > claude-sonnet-4-20250514: $1.321200
2025-10-03 > gpt-4-turbo: $0.250000

🗂️ JSON Mode

Full precision for accounting and integration

vct usage --json

{
  "2025-10-01": [
    {
      "model": "claude-sonnet-4-20250514",
      "usage": {
        "input_tokens": 45230,
        "output_tokens": 12450,
        "cache_read_input_tokens": 230500,
        "cache_creation_input_tokens": 50000,
        "cache_creation": {
          "ephemeral_5m_input_tokens": 50000
        },
        "service_tier": "standard"
      },
      "cost_usd": 2.1542304567890123
    }
  ]
}

🔍 Output Comparison

Feature	Interactive	Table	Text	JSON
Best For	Monitoring	Reports	Scripts	Integration
Cost Format	$2.15	$2.15	$2.154230	2.1542304567890123
Updates	Real-time	Static	Static	Static
Colors	✅	✅	❌	❌
Parseable	❌	❌	✅	✅

💡 Use Cases

Budget Tracking: Monitor your daily AI spending
Cost Optimization: Identify expensive sessions
Team Reporting: Generate usage reports for management
Billing: Export precise costs for invoicing
Monitoring: Real-time dashboard for active development

📊 Analysis Command

Deep dive into specific conversation files.

Basic Usage

# Analyze and display
vct analysis --path ~/.claude/projects/session.jsonl

# Save to file
vct analysis --path ~/.claude/projects/session.jsonl --output report.json

What You Get

Detailed JSON report including:

Token Usage: Input, output, and cache statistics by model
File Operations: Every read, write, and edit with full details
Command History: All shell commands executed
Tool Usage: Counts of each tool type used
Metadata: User, machine ID, Git repo, timestamps

Sample Output

{
  "extensionName": "Claude-Code",
  "insightsVersion": "0.1.0",
  "user": "wei",
  "machineId": "5b0dfa41ada84d5180a514698f67bd80",
  "records": [
    {
      "conversationUsage": {
        "claude-sonnet-4-20250514": {
          "input_tokens": 252,
          "output_tokens": 3921,
          "cache_read_input_tokens": 1298818,
          "cache_creation_input_tokens": 124169
        }
      },
      "toolCallCounts": {
        "Read": 15,
        "Write": 4,
        "Edit": 2,
        "Bash": 5,
        "TodoWrite": 3
      },
      "totalUniqueFiles": 8,
      "totalWriteLines": 80,
      "totalReadLines": 120,
      "folderPath": "/home/wei/repo/project",
      "gitRemoteUrl": "https://github.com/user/project.git"
    }
  ]
}

💡 Use Cases

Usage Auditing: Track what the AI did in each session
Cost Attribution: Calculate costs per project or feature
Compliance: Export detailed activity logs
Analysis: Understand coding patterns and tool usage

🔧 Version Command

Check your installation.

# Formatted output
vct version

# JSON format
vct version --json

# Plain text
vct version --text

Output

🚀 Vibe Coding Tracker

╔════════════════╦═════════╗
║ Version        ║ 0.1.0   ║
╠════════════════╬═════════╣
║ Rust Version   ║ 1.89.0  ║
╠════════════════╬═════════╣
║ Cargo Version  ║ 1.89.0  ║
╚════════════════╩═════════╝

💡 Smart Pricing System

How It Works

Automatic Updates: Fetches pricing from LiteLLM daily
Smart Caching: Stores pricing in ~/.vibe-coding-tracker/ for 24 hours
Fuzzy Matching: Finds best match even for custom model names
Always Accurate: Ensures you get the latest pricing

Model Matching

Priority Order:

✅ Exact Match: claude-sonnet-4 → claude-sonnet-4
🔄 Normalized: claude-sonnet-4-20250514 → claude-sonnet-4
🔍 Substring: custom-gpt-4 → gpt-4
🎯 Fuzzy (AI-powered): Uses Jaro-Winkler similarity (70% threshold)
💵 Fallback: Shows $0.00 if no match found

Cost Calculation

Total Cost = (Input Tokens × Input Cost) +
             (Output Tokens × Output Cost) +
             (Cache Read × Cache Read Cost) +
             (Cache Creation × Cache Creation Cost)

🐳 Docker Support

# Build image
docker build -f docker/Dockerfile --target prod -t vct:latest .

# Run with your sessions
docker run --rm \
  -v ~/.claude:/root/.claude \
  -v ~/.codex:/root/.codex \
  vct:latest usage

🔍 Troubleshooting

Pricing Data Not Loading

# Check cache
ls -la ~/.vibe-coding-tracker/

# Force refresh
rm -rf ~/.vibe-coding-tracker/
vct usage

# Debug mode
RUST_LOG=debug vct usage

No Usage Data Shown

# Verify session directories
ls -la ~/.claude/projects/
ls -la ~/.codex/sessions/

# Count JSONL files
find ~/.claude/projects -name "*.jsonl" | wc -l
find ~/.codex/sessions -name "*.jsonl" | wc -l

Analysis Command Fails

# Validate JSONL format
jq empty < your-file.jsonl

# Check file permissions
ls -la your-file.jsonl

# Run with debug output
RUST_LOG=debug vct analysis --path your-file.jsonl

Interactive Mode Issues

# Reset terminal if broken
reset

# Check terminal type
echo $TERM  # Should be xterm-256color or compatible

# Use static table as fallback
vct usage --table

⚡ Performance

Built with Rust for speed and reliability:

Operation	Time
Parse 10MB JSONL	~320ms
Analyze 1000 events	~45ms
Load cached pricing	~2ms
Interactive refresh	~30ms

Binary Size: ~3-5 MB (stripped)

📚 Learn More

Developer Docs: See .github/copilot-instructions.md
Report Issues: GitHub Issues
Source Code: GitHub Repository

🤝 Contributing

Contributions welcome! Here's how:

Fork the repository
Create your feature branch
Make your changes
Submit a pull request

For development setup and guidelines, see .github/copilot-instructions.md.

📄 License

MIT License - see LICENSE for details.

🙏 Credits

LiteLLM for model pricing data
Claude Code and Codex teams for creating amazing AI coding assistants
The Rust community for excellent tooling

Save money. Track usage. Code smarter.

⭐ Star this project if you find it useful!

Made with 🦀 Rust

vibe_coding_tracker 0.1.2

Vibe Coding Tracker — AI Coding Assistant Usage Tracker

🎯 Why Vibe Coding Tracker?

💰 Know Your Costs

📊 Beautiful Visualizations

🚀 Zero Configuration

🎨 Rich Insights

✨ Key Features

🚀 Quick Start

Installation

First Run

📖 Command Guide

🔍 Quick Reference

💰 Usage Command

Basic Usage

What You Get

🎨 Interactive Mode (Default)

📋 Static Table Mode

📝 Text Mode

🗂️ JSON Mode

🔍 Output Comparison

💡 Use Cases

📊 Analysis Command

Basic Usage

What You Get

Sample Output

💡 Use Cases

🔧 Version Command

Output

💡 Smart Pricing System

How It Works

Model Matching

Cost Calculation

🐳 Docker Support

🔍 Troubleshooting

Pricing Data Not Loading

No Usage Data Shown

Analysis Command Fails

Interactive Mode Issues

⚡ Performance

📚 Learn More

🤝 Contributing

📄 License

🙏 Credits