Costburn: track your spends

A native macOS menubar app that tracks Neon database costs and local AI agent usage for Copilot, Claude, and Codex.

curl -fsSL https://raw.githubusercontent.com/sanjeev-pandey23/costburn/main/install.sh | bash

One command — downloads the latest release, installs into ~/Applications, and launches it. Re-run with --force to reinstall.

Via Homebrew:

brew tap sanjeev-pandey23/costburn
brew install --cask costburn

---

What it shows

• Current month spend estimate in the menubar (e.g. $3.42)
• Click to expand (NeonDB): compute hours, storage GB-months, egress
• Per-project breakdown (org accounts) for NeonDB
• AI Usage tab with Copilot, Claude, and Codex breakdowns
• Daily spend trend chart
• Configurable spend limit with notifications at 80% and 100%
• Launch at login — start automatically when you log in

Requirements

• macOS 14 (Sonoma) or later
• For NeonDB: Neon account on Launch, Scale, or Business plan
• For NeonDB: Neon API key (free to generate at console.neon.tech/app/settings/api-keys)
• For AI Usage: local agent logs only; no API keys required

Setup

1. Launch the app — click the $--.-- icon in your menubar
2. Click the gear icon to open Settings
3. For NeonDB: Paste your Neon API key. No setup is needed for AI Usage
4. For NeonDB: Optionally add your Organization ID for per-project breakdown
5. Choose your Neon tier, Copilot plan, and optional AI spend limits
6. Enable Launch at login so CostBurn starts automatically (macOS will prompt for approval on first enable)

Pricing accuracy

For Neon, the app uses Neon's published rates from https://neon.tech/pricing and computes estimates from raw usage metrics (CU-seconds, byte-hours, data transfer bytes). Actual invoiced amounts may differ slightly due to free-tier allowances, prorations, or plan discounts. Use Settings → Custom to override any per-unit rate.

For AI Usage, CostBurn reads local logs only:

• Copilot: ~/.copilot/session-state/*/events.jsonl, plus VS Code and JetBrains transcripts when available
• Claude: Claude Code JSONL transcripts under ~/.claude/projects
• Codex: token-count events under ~/.codex/sessions

Copilot shows premium request credits. Claude and Codex show token-based cost estimates from the bundled pricing table; actual invoices may differ.

Building from source

Requires Xcode 16+ / Swift 6.

git clone https://github.com/sanjeev-pandey23/costburn
cd costburn
./Scripts/package-app.sh 0.0.9
open .build/CostBurn.app

Releasing

git tag mac-v0.0.9
git push origin mac-v0.0.9

GitHub Actions builds a universal binary (arm64 + x86_64), creates a release, and updates the Homebrew formula automatically.

Roadmap

• v0.2 — Swift Charts daily spend graph
• v0.3 — Local notifications at spend limits