TOKENBAR

Your AI usage limits, on an LED display.

Claude Code, Codex, GitHub Copilot, Windsurf, Cursor, Gemini, Kiro, GLM, Kimi, MiniMax, Amp or any AI — how much of the 5-hour and 7-day limits you've used and when they reset. On Mac, Windows, Linux, iPhone, Android, Apple Watch, Wear OS, VS Code, Raycast and Stream Deck.

Maccurl -fsSL https://raw.githubusercontent.com/ChaconLucas/tokenbar/main/scripts/install-mac.sh | sh

CLI + MCP servercurl -fsSL https://raw.githubusercontent.com/ChaconLucas/tokenbar/main/scripts/install-cli.sh | sh

Local APIcurl localhost:41777/v1/usage

LOCAL API

JSON on localhost:41777. Every app and script on your computer can read your usage.

MCP SERVER

Claude Code, Codex and Cursor can check your budget before starting a long task.

CLI

tokenbar, --json, --prompt for your shell prompt, get for scripts.

WEBHOOKS

80%, 95% and reset events to Slack, Discord, Home Assistant or any URL.

ANY AI

Write a small JSON file and it shows up everywhere — phone, watch and widgets included.

Install in your AI

The MCP server lets your AI check its own limit before a long task. Install the CLI first (command above), then click your tool. Cursor and VS Code install in one click; for the others, the installer writes the config for you with --add-to.

Cursorone click ↗ VS Codeone click ↗ VS Code Insidersone click ↗ Claude DesktopTokenBar.mcpb ↗ Claude Codesetup → Codexsetup → Windsurf / Devinsetup → Gemini CLIsetup → Antigravitysetup → Clinesetup → OpenCodesetup → Continuesetup → Goosesetup → Zedsetup → Kirosetup → Ampsetup → JetBrains AIsetup → Warpsetup →

Write the config for any tool (Mac / Linux)curl -fsSL https://raw.githubusercontent.com/ChaconLucas/tokenbar/main/scripts/install-cli.sh | sh -s -- --add-to cursor,vscode,zed