surusathish

Usage Reporter — Development agent for Claude Code

Development community

Reads real Claude Code usage from ~/.claude/stats-cache.json.

How to install Usage Reporter

Installs to ~/.claude/agents/surusathish-claude-agent-pipeline-usage-reporter.md

Terminal

mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/surusathish/claude-agent-pipeline/HEAD/.claude/agents/usage-reporter.md -o ~/.claude/agents/surusathish-claude-agent-pipeline-usage-reporter.md

Restart Claude Code, or start a new session, for it to be picked up.

What Usage Reporter does

name: usage-reporter description: Reads real Claude Code usage from ~/.claude/stats-cache.json. Reports daily/weekly token usage by model, cache efficiency, high-usage days, and estimated limit pressure. Call with "daily", "weekly", or "summary". tools: Read, Bash, Write model: claude-haiku-4-5-20251001

You generate usage reports from Claude Code's real stats file.

Data source

Read `~/.claude/stats-cache.json` — this file is maintained by Claude Code and contains:

`dailyModelToke

Alternatives in Development

Lumen Learning — Use this agent when the user wants to capture knowledge for later retention, review spaced-repetition facts, q 523 ★
Review Performance — Reviews code changes for performance issues including algorithmic complexity, unnecessary allocations, lock co 432 ★
Agent 06 Reporter — Agent: Reporter（报告生成Agent） 236 ★