awarts

Track your AI coding spend across Claude, Codex, Gemini & Antigravity.

AWARTS (A Worldwide AI Rating & Tracking System) is the Strava for AI-assisted coding. This CLI automatically detects your AI tool usage and syncs it to awarts.vercel.app so you can track spend, compare with others, and climb the leaderboard.

Install

npx awarts@latest

Or install globally:

npm i -g awarts

Requires Node.js 18+.

Quick Start

# 1. Authenticate with your AWARTS account
awarts login

# 2. Auto-detect all providers and push usage data
awarts sync

# 3. Start background auto-sync (every 5 minutes)
awarts daemon start

Commands

| Command | Description | |---------|-------------| | awarts login | Authenticate via device auth flow | | awarts sync | Auto-detect all providers and push data | | awarts push | Push data from specific provider | | awarts status | Show auth status and detected providers | | awarts seed | Generate sample data for testing | | awarts daemon start | Start background auto-sync daemon | | awarts daemon stop | Stop the daemon | | awarts daemon status | Check if daemon is running | | awarts daemon logs | View daemon output | | awarts keys set | Store an API key for a provider | | awarts keys list | List stored keys (masked) | | awarts keys remove | Remove a stored key | | awarts logout | Clear stored credentials |

Supported Providers

| Provider | Detection | Path | |----------|-----------|------| | Claude | Auto-detected | ~/.claude/stats-cache.json | | Codex | Auto-detected | ~/.codex/usage/ | | Gemini | Auto-detected | ~/.gemini/usage/ | | Antigravity | Auto-detected | ~/.antigravity/usage/ |

Using Pro subscriptions (no API keys)?

No problem. The CLI reads local files created by your AI tools. No API keys required.

• Claude Code usage is auto-detected from ~/.claude/
• For Codex, Gemini, and Antigravity, place usage files in their respective directories or import via the web at Settings > Import

Options

# Push data for a specific provider only
awarts push --provider claude

# Preview what would be pushed (dry run)
awarts push --dry-run

# Generate 14 days of sample data
awarts seed --days 14

# Set sync interval to 10 minutes
awarts daemon start --interval 10

# Force re-authentication
awarts login --force

API Key Management

Store API keys locally for provider billing data. Keys are stored in ~/.awarts/keys.json and never leave your machine.

awarts keys set openai sk-...
awarts keys set google AIza...
awarts keys list
awarts keys remove openai

Data Storage

All credentials and keys are stored locally:

| File | Purpose | |------|---------| | ~/.awarts/auth.json | Authentication token | | ~/.awarts/keys.json | API keys (local only) | | ~/.awarts/daemon.pid | Daemon process ID | | ~/.awarts/daemon.log | Daemon log output |

Web App

View your stats, follow other developers, and climb the leaderboard at:

awarts.vercel.app

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT - Harshal Jain (harry.dev)