burntop

A gamified AI usage tracking platform for developers. Track your AI tool consumption, compete on leaderboards, and share your stats.

Overview

burntop helps developers visualize and gamify their AI coding assistant usage across tools like Claude Code, Cursor, Gemini CLI, Aider, and more. Features include:

• Usage Dashboard - Track tokens, costs, and usage patterns over time
• Leaderboards - Compete globally or with friends
• Shareable Cards - Generate OG images and embeddable badges
• CLI Sync - Automatic usage data collection from local tools

CLI Installation

Run burntop directly without installing:

bunx burntop sync

Or install globally:

bun add -g burntop    # recommended
npm install -g burntop
pnpm add -g burntop

Note: The CLI requires Bun runtime.

Quick Start

# Authenticate with your account
bunx burntop login

# Sync your local data to the cloud
bunx burntop sync

# View your AI usage stats
bunx burntop stats

# View the leaderboard
bunx burntop leaderboard

# See all available commands
bunx burntop --help

Supported Tools

The CLI automatically detects and parses usage data from:

• Claude Code - ~/.claude/projects/**/*.jsonl
• Cursor - SQLite database in Application Support
• Gemini CLI - ~/.gemini/tmp/*/chats/session-*.json
• Aider - ~/.aider/
• Continue - ~/.continue/sessions/

Project Structure

This is a monorepo using bun workspaces:

packages/
  backend/   # FastAPI backend with async SQLAlchemy
  frontend/  # TanStack Start web application
  cli/       # CLI tool for syncing usage data

Prerequisites

• Node.js 20+
• Bun 1.3+
• Docker and Docker Compose (for local database)

Development Setup

1. Install Dependencies

bun install

2. Database Setup

The application requires PostgreSQL. Use Docker Compose for local development:

# Start PostgreSQL container
docker compose up -d

# Run database migrations
cd packages/backend && uv run alembic upgrade head

Database configuration:

• Local connection: postgresql://burntop:burntop_dev_password@localhost:5432/burntop
• Container name: burntop-postgres
• Environment variables in packages/backend/.env

To stop the database:

# Stop container (preserves data)
docker compose down

# Remove container and data (destructive)
docker compose down -v

3. Start Development Servers

# Start all packages in dev mode
bun dev

# Or run only the frontend
bun --filter frontend dev

# Or run only the backend
cd packages/backend && uv run uvicorn src.app.main:app --reload

Scripts

Command	Description
bun dev	Start all packages in dev mode
bun build	Build all packages
bun lint	Run ESLint
bun lint:fix	Fix auto-fixable lint issues
bun format	Format with Prettier
bun typecheck	Run TypeScript type checking
bun test	Run tests

Tech Stack

• Frontend: TanStack Start, TanStack Router, TanStack Query, Tailwind CSS, shadcn/ui
• Backend: FastAPI, async SQLAlchemy 2.0, Pydantic v2
• Database: PostgreSQL
• Auth: Better Auth with GitHub OAuth
• CLI: TypeScript with Commander.js, Bun runtime

License

MIT