Your spend, where you already are.

Menu-bar app for macOS

Your month-to-date total sits in the menu bar all day — — and clicking it opens the per-provider breakdown, a forecast, and how much prepaid balance is left.

It refreshes on a schedule you set, and updates itself when there's a new version. Your API key and vault password live in the macOS Keychain — the server never sees either.

1. Sign in and connect your providers in the web dashboard.
2. In the web dashboard, generate a programmatic key under Settings → API keys.
3. In the app, right-click the menu-bar icon and choose Settings. Paste the key under Account, and your vault password under Vault — each with its own Verify & Save. Both are stored in the macOS Keychain.

Claude Code plugin

Ask in plain language and it runs the CostCompass CLI for you — no web dashboard, no context switch. Install it from the marketplace:

/plugin marketplace add costcompasscc/costcompass-skill
/plugin install costcompass@costcompass-skill

The plugin ships with the CLI, which is Python — so it needsuvinstalled, one command, and it brings its own Python. (Already have Python 3.11 or newer? That works too.) It authenticates with the same programmatic key as the menu-bar app, and decrypts your vault locally to reach your providers.

1. In the web dashboard, generate a programmatic key under Settings → API keys.
2. Ask it anything about your spend. On the first run it walks you through storing the key.
3. Run the command it gives you in a real terminal window, not inside Claude Code — the prompt is hidden, and a hidden prompt needs a real terminal.

Your API key and vault password are verified before they're stored, are never accepted as command-line arguments, and are kept in your operating system's credential store.