ruflo-token-audit

Solid

Use when the user asks where their Claude Code usage/tokens are going, is burning through their plan unexpectedly fast, hitting limits, or wants a breakdown of their Claude Code activity. Produces a COMPREHENSIVE usage report from local session transcripts: tokens by day/model/project, tool usage, MCP usage, subagent fan-out, web-tool calls, cache efficiency, busiest sessions, hourly activity, and a runaway-daemon cross-reference — distinguishing interactive work from automation and recommending concrete fixes.

AI & Automation 56 stars 6 forks Updated today MIT

Install

View on GitHub

Quality Score: 84/100

Stars 20%
58
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Claude Code Usage Audit (ruflo-token-audit) A **comprehensive** picture of Claude Code usage, built from the local session transcripts in `~/.claude/projects/**/*.jsonl` (each assistant message records its token usage, tool calls, model, and metadata). This is **not limited to "tokens ruflo burns"** — it summarizes the activity visible in retained Claude Code transcripts (including recorded subagent and tool activity) and answers two questions: *where is my usage going?* and *is any of it runaway automation?* This skill is **self-contained** — it bundles its own engine, so it works even if the full agentic-kit kit isn't installed. ## When to use Trigger on: "where are my tokens/usage going", "why is my usage so high", "break down my Claude Code activity", "I'm hitting my Max/Pro limit", "what am I spending tokens on", "is the plan worth it". Also proactively if the user mentions surprising usage. ## Procedure 1. **Run the bundled engine.** Prefer the copy that ships *inside this skill* (works with no kit install); fall back to the PATH command if present: ```bash # self-contained (always available wherever this skill is installed): python3 ~/.claude/skills/ruflo-token-audit/scripts/ruflo-token-audit.py --days 7 # …or, if the agentic-kit kit put it on PATH: ruflo-token-audit --days 7 ``` - Honor any window the user gives ("past month" → `--days 30`). - `--top N` widens each section; `--json` gives machine-readable output; `--no-daemons` ...

Details

Author
pacphi
Repository
pacphi/agentic-kit
Created
4 months ago
Last Updated
today
Language
JavaScript
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

Data & Documents Listed

usage-audit

Measure actual Claude Code usage from local session data and report concrete numbers - largest token sinks, which tools and files dominate, session and message counts, MCP overhead, and the specific changes that would cut the most. Produces measurements, never generic efficiency advice. Use before optimizing anything, when hitting usage limits, or to find out where the cost actually goes. Trigger on "token audit", "where are my tokens going", "usage audit", "why am I hitting limits", "measure my usage", "what's expensive", "/token-audit".

1 Updated 1 months ago
Lukehle
AI & Automation Listed

claude-usage-report

Aggregate Claude Code usage (tokens, sessions, API-equivalent cost) by day, week, month, model, and project from local JSONL session logs. Use when the user asks about their Claude Code usage, consumption, costs, "cuánto he usado", "uso diario/semanal/mensual", or wants to audit which projects/models are eating the most tokens.

17 Updated 2 days ago
CarlosCaPe
Code & Development Listed

usage-analysis

Use when the user asks an interpretive question about their Claude Code token spend — what's interesting, what's anomalous, what to change. This skill produces insights and questions; it does NOT enumerate top consumers (the dashboard does that). Use `usage-dashboard` for "show me the numbers." Use `claude-audit` for "audit my config overlap." Use this skill for "tell me what's interesting / what should I change." Trigger phrases: "am I close to my Claude limit", "how much Sonnet am I using", "where are my Claude tokens going", "what's eating my Claude budget", "why is my Claude spend so high", "what should I change about my Claude setup".

3 Updated 6 days ago
glitchwerks