Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (awarts) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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)