Monitors Claude Code and OpenCode sessions locally in real time, showing tokens, costs, tool calls, agents, MCP activity, sessions and quotas as they run.
$ npm install -g @statforge/claudestat
Real-time observability for AI coding agents — Claude Code & OpenCode
Monitor tokens, costs, tool calls, agents, MCP, sessions, quotas and multi-agent orchestration locally. Most tools read your logs after a session ends. claudestat hooks into every event as it fires. See what your AI is spending right now, get alerted before you hit your quota, and ask Claude about its own usage — from inside the terminal.
Works with Claude Code and OpenCode. Zero cloud dependencies. Pure Node.js. Runs on macOS, Linux, and Windows.
Installation • Quick Start • Commands • Dashboard • Library API • FAQ • Discussions • Contributing
Live dashboard · terminal trace · quota guard — all running in real time
Two different jobs exist in the coding-agent space:
claudestat hooks Claude Code's events the moment they fire, keeps everything local in SQLite, and surfaces a live web dashboard, quota alerts, and an MCP server.
| claudestat | ccusage | OpenUsage | Langfuse | Agent Trail | |
|---|---|---|---|---|---|
| Real-time event stream | ✅ | partial | ✅ | ✅ | ✅ |
Live terminal trace (watch) | ✅ | — | — | — | — |
| Web dashboard | ✅ | — | TUI | ✅ | ✅ |
| Quota alerts + kill switch | ✅ | — | quota only | — | — |
| Loop / thrash detector | ✅ | — | — | — | — |
| MCP server (ask Claude about itself) | ✅ | — | — | — | — |
| Claude Code support | ✅ | ✅ | ✅ | ✅ | ✅ |
| OpenCode support | ✅ | ✅ | ✅ | — | — |
| Tool tracing | ✅ | limited | — | ✅ | ✅ |
| Agents / subagents | ✅ | — | — | ✅ | ✅ |
| Orchestration view | ✅ | — | — | ✅ | ✅ |
| Historical reports | ✅ | ✅ | partial | ✅ | ✅ |
| Local-first / SQLite (no cloud) | ✅ | ✅ | ✅ | configurable | ✅ |
The main difference is the moment: ccusage answers what did I spend yesterday; claudestat shows what's happening while you code. Langfuse and Agent Trail offer observability but are cloud-first or require infrastructure setup.
If claudestat is useful, give it a ⭐ — it helps other developers find it.
ClaudeStat is for developers who use AI coding agents and want to understand what those agents are doing, how much they cost, and when they become inefficient.
Especially useful if you:
Use ClaudeStat when you want to:
claudestat ships an MCP server. Once registered, you can ask Claude Code questions about its own usage — without leaving the terminal.
claude mcp add claudestat -s user -- claudestat-mcp
Then just ask:
> How much did I spend this week?
> What are my top 5 tools by cost?
> Break down my usage by model
> What's my cost projection for next month?
cost-state totalclaudestat blocks)claudestat share)@statforge/claudestat-mcp-bundledbOps, pricing, and intelligence functions directly from your own tools (v1.13.0+, @experimental)npm install -g @statforge/claudestat && claudestat setup
open http://localhost:7337
Start a Claude Code session and watch the events flow in. That's it.
node:sqlite)npm install -g @anthropic-ai/claude-code)npm install -g @statforge/claudestat && claudestat setup
claudestat setup installs the Claude Code hooks and registers the daemon as a system service — no sudo required. The daemon starts automatically whenever you log in (launchd on macOS, systemd on Linux, Scheduled Task on Windows).
Using NVM? Make sure you're on your default Node version:
nvm use default && npm install -g @statforge/claudestat && claudestat setupRestart Claude Code after setup so the hooks take effect.
npm install -g @statforge/claudestat
claudestat install # installs hooks into Claude Code
claudestat start # start the daemon manually
| Command | Description |
|---|---|
claudestat setup | One-command setup: install hooks + register daemon as system service |
claudestat setup --uninstall | Remove hooks and system service |
claudestat start / stop / restart | Manage the background daemon |
claudestat install / uninstall | Install or remove Claude Code hooks |
claudestat watch | Live terminal trace view |
claudestat status | Show quota, cost, and burn rate |
claudestat top | Rank tools by cost, call count, or duration |
claudestat weekly | Weekly usage summary |
claudestat insights | Deep usage insights: cost, cache, efficiency, models |
claudestat project | Cost projection with linear regression |
claudestat config | View or edit configuration |
claudestat doctor | Check installation health and diagnose issues |
claudestat blocks | Show 5-hour billing block history |
claudestat share [session-id] | Export session summary as ASCII or JSON (use --copy to copy to clipboard) |
claudestat export [format] | Export session data to JSON or CSV |
claudestat roast | Sarcastic usage analysis |
claudestat resume | Resume a paused session |
claudestat loops | List sessions with detected loops (context thrashing) |
claudestat logs | Show daemon logs (use -n, --follow, --level) |
claudestat update | Check for updates and install the latest version from npm |
claudestat version | Show version and check for updates |
Full command reference with output examples →
The dashboard lives at http://localhost:7337 and has seven tabs: Live, History, Projects, Analytics, Top, System, and Orchestrate.
claudestat was engineered by a human developer working with AI as a pair programming partner. The AI accelerated implementation — architecture, design, and engineering decisions stayed human. Fittingly, claudestat measures itself: every metric below comes from its own event database.
| Human-owned | AI implemented, always human-reviewed |
|---|---|
| Product vision & feature design | TypeScript service generation |
| MCP server protocol & design | Tool scaffolding, dashboard components |
| Data model (SQLite schema) | Refactoring, test scaffolding |
| Architecture decisions | Config parsing, CLI commands |
Stars on GitHub
A development methodology for coding agents that makes the agent brainstorm before building, follow plans, run parallel work and finish branches in a disciplined way. You get fewer skipped steps and more consistent results from your coding assistant.
@obraHelps you take a change from a rough idea or bug report through to a tested, reviewed result, with each step handled by a focused skill. Its skills cover pinning down domain terms, designing module interfaces, diagnosing hard bugs, and reviewing changes against your repo's coding standards.
@mattpocockGives your coding agent a planning, testing and review routine to follow on every task. It plans before building, checks changes with tests, has a fresh reviewer look for regressions, and saves repeated wins as reusable skills.
@affaan-mDeveloper tools for working on the React codebase itself. Provides skills for extracting error messages, managing and debugging feature flags across release channels, running Flow type checks, and fixing lint and formatting issues before committing.
@facebookMonitors Claude Code and OpenCode sessions locally in real time, showing tokens, costs, tool calls, agents, MCP activity, sessions and quotas as they run. Install it with the command on its page. Free and open source.
Is this plugin yours?
Claim it with GitHubSubmit a pluginPromote it