ai-usage-reportlisted

# AI Usage Report Generates a self-contained HTML file with a token & cost overview across **Claude Code, Codex, and Hermes** for a freely chosen period. Layout: KPI cards · cost/token donut · three agent cards (input/output/cache/models) · breakdown table · daily line and stacked-bar charts with hover tooltips. Dark theme, print-/share-friendly, no external dependencies in the finished HTML. The data source is **`ccusage`** (via `npx`), which knows all three tools natively. Charts and overview always use **the same period and the same data**. ## Workflow 1. **Determine the period** as `--since` / `--until` (both `YYYY-MM-DD`, inclusive). Derive it from the current date: - "for June" / "June 2026" → `--since 2026-06-01 --until 2026-06-30` (if the month is still running, `--until` = today). - "last 7 days" → `--until` = today, `--since` = today − 6. - "this month" / "so far this month" → first of the month until today. - "last month" → from the first to the last day of the previous month. - A concrete span like "May 1–15" → accordingly. On genuine ambiguity, ask briefly; otherwise default sensibly (current month up to today). 2. **Generate** (path relative to this skill's directory — substitute the skill's actual base directory): ```bash node "<skill-dir>/scripts/generate.mjs" --since <YYYY-MM-DD> --until <YYYY-MM-DD> [--out <path.html>] ``` When installed via `skillctl`, `<skill-dir>` is `~/.claude/skills/ai-usage-report`; in this repo it is