The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Observer
Track what every AI coding agent costs and see the limit coming. Per-session, per-model cost for Claude Code, Codex, Cursor and 37 more tools from your provider's own token…
Install
npx @superbased/observerclaude mcp add observer -- npx @superbased/observer{
"mcpServers": {
"observer": {
"command": "npx",
"args": [
"@superbased/observer"
]
}
}
}Install command taken from the project's README or registry entry. Always review code before running it.
README excerpt
Read full README on GitHub →Track what every AI coding agent costs. See the limit coming.
See what Claude Code, Codex, Cursor and 37 more AI coding tools cost, per session and per model, from the tokens your provider actually billed. Free, Apache-2.0, and it runs on your machine.
Quickstart · Docs · Compare · Changelog · Website
Try it in one command
npx @superbased/observer
No install, no config, no network. It reads the session logs your coding agents already keep on disk, prints a 30-day cost table by tool and model, and deletes its temporary database on exit.
Why SuperBased
One local binary that tracks Claude Code token usage, Codex cost and Cursor spend side by side, and helps you control them.
- Provider-exact cost, not estimates. An optional local proxy records the tokens your provider returned: net input, 5-minute vs 1-hour cache writes, reasoning tokens and long-context repricing. Log-only trackers have to estimate those.
- Every coding agent in one place. 40 adapters normalize Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Cline, Aider, Kiro, Devin, OpenCode, Junie and more into one local database.
- Local-first, no account. No telemetry and no sign-in. The watcher, dashboard, MCP server and CLI
make no outbound calls on your behalf; everything lives in one SQLite file under
~/.observer/. - Know the next bill before it lands. Prompt-cache tracking with expiry warnings, a low / typical / high cost band for your next message, and a 5-hour and weekly limit gauge for proxied sessions.
- Guardrails on your own agents. The guard checks each agent action against built-in rules
(destructive commands, secrets egress, MCP pinning, budgets) and your own. It starts in observe
mode;
observer guard simulatereplays your history before you turn on enforcement. - Your agents as terminals, from anywhere. Launch agent CLIs from the dashboard as real terminals, join a running session from a paired device over your Tailscale tailnet, and hand a session from one tool to another.
How it compares
| SuperBased | ccusage | CodeBurn | Langfuse | Helicone | LiteLLM | |
|---|---|---|---|---|---|---|
| Built for | Coding-agent cost & control | CC/Codex cost meter | Local CC spend + budget toolkit | LLM-app observability | LLM-app observability + gateway | AI gateway |
| Coding tools covered | 40 adapters | Claude Code, Codex, + companion pkgs | 31-36 per their own docs | Instrument-per-app | Instrument-per-app | Anything routed through it |
| Provider-reported (not estimated) tokens | ✓ via local proxy | Partial (from logs) | Partial (from logs) | ✓ (SDK) | ✓ (proxy) | ✓ (proxy) |
| Cache 5-min vs 1-hour write split | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ |
| Reasoning + long-context surcharge accounting | ✓ | Partial | Partial | Partial | Partial | Partial |
| Runs 100% local, no cloud required | ✓ | ✓ | ✓ (opt-in team-sync preview) | Self-host a stack | Self-host or SaaS | Self-host |
| Agent-queryable memory over your history (MCP) | ✓ | ✓ (usage MCP) | ✓ | ✓ (trace MCP) | ✗ | ✗ |
| Cross-tool session handoff | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ |
| License | Apache-2.0 | MIT | MIT | MIT (core) | Apache-2.0 | MIT |
Checked against each project's public repo (July 2026). Each of these tools is good at what it was built for; the full comparison covers more tools and when to pick which.
Install
Similar plugs
Reverse engineer anything with agents, from app behavior down to native binaries.
Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype…
User-friendly AI Interface (Supports Ollama, OpenAI API, ...)
A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io
Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.