Costats

costats

A lightweight Windows tray app that shows live status, plus token usage and spend, for AI coding providers like Codex and Claude Code, optionally GitHub Copilot.

What it shows
- Session and weekly utilization with reset timers and pace indicators.
- Daily tokens + cost and 30-day rolling tokens + cost.
- Overage or credit balance when available.
- One-tap tray widget and a global hotkey (Ctrl+Alt+U).

Install

One-step PowerShell (technical)

Downloads the latest release, installs per-user and creates a Start Menu shortcut.
Portable installs now auto-check for updates in the background on startup and stage updates safely for the next launch.

From source: see Build below.

Usage
- Click the tray icon to open the widget.
- Press Ctrl+Alt+U to toggle the widget (configurable).
- Open Settings to set refresh interval or start at login.

Insights Card CLI
Generate a shareable Claude Code Insights card from report.html (full docs):

By default it reads ~/.claude/usage-data/report.html and writes the PNG to ~/.costats/images/costats-insights.png.

Optional flags:
- --json  to export the extracted JSON alongside the PNG.
- --no-open to avoid opening the image viewer.
Requires an active Claude Code OAuth login (uses ~/.claude/.credentials.json).
First run may download a Playwright Chromium binary for rendering.

Configuration
Settings are stored at:
%LOCALAPPDATA%\costats\settings.json

Common settings:
- RefreshMinutes (default 5)
- Hotkey (default Ctrl+Alt+U)
- StartAtLogin (true/false)
- CopilotEnabled (true/false)

Optional environment variable:
- CODEX_HOME to point to a custom Codex config/logs directory.

GitHub Copilot (experimental)
1. Create a classic GitHub personal access token with the copilot and read:user scopes.
2. Open Settings → Copilot, enable the…