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

See it in action

Live dashboard · terminal trace · quota guard — all running in real time

---

Table of Contents

• Why claudestat?
• Who is ClaudeStat for?
• Use ClaudeStat if...
• Ask Claude about itself
• Features
• Quick Start
• Requirements
• Installation
• Commands
• Dashboard
• Library API
• OpenCode Support
• MCP Server
• MCP Bundle (standalone)
• Configuration
• Troubleshooting
• FAQ
• Uninstall
• Contributing
• License

---

Why claudestat?

Two different jobs exist in the coding-agent space:

• What happened — costs, token totals, daily/weekly/monthly reports. ccusage is the historical-analysis reference.
• What is running right now — the live session, the live budget, before the quota runs out. claudestat and OpenUsage live here.

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.

---

Who is ClaudeStat for?

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: