surusathish

Usage Reporter

Name: Usage Reporter
Author: surusathish

Development community

SOURCE https://github.com/surusathish/claude-agent-pipeline/blob/main/.claude/agents/usage-reporter.md

Description

--- 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

Installation

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.