Observer — AI skill for Claude Code

SuperBased

The exact tokens your AI provider billed you — cache splits, reasoning tokens, long-context surcharges — reconciled across 29 coding tools, entirely on your own machine. Nothing you build here ever leaves your machine unless you opt a node into it.

[](https://www.npmjs.com/package/@superbased/observer) [](https://www.apache.org/licenses/LICENSE-2.0) [](#install) [](https://go.dev/) [](https://github.com/superbasedapp/observer)

If SuperBased catches something useful in your next bill, a star helps other people looking for the same thing find it.

Try it in one command

npx @superbased/observer

On a fresh machine — no `~/.observer/observer.db`, no `~/.observer/config.toml` — this scans every AI coding tool's own local session files into a throwaway temp database, prints one cost table grouped by tool and model, and deletes the database again before it exits. It's local-only: zero network calls, and nothing is written outside that temp directory (foreign-mount adapter mirrors — e.g. WSL reading a Windows-side tool store — are redirected there too; pricing is embedded in the binary, not fetched at runtime).

Already have SuperBased set up (or want the explicit form)? Run `observer usage`. Bare `observer` only runs the one-shot on a machine with no local SuperBased state at all — otherwise it prints the usual welcome screen (`OBSERVER_ONESHOT=off` to always get the welcome screen). This is the zero-con