What problem does it solve?
It turns a raw token-usage ledger (memory/token-usage.csv) into a one-glance visual recap, so an operator can see weekly and all-time token consumption, run counts, and top skills without manually aggregating CSV rows.
Core Features & Use Cases
- Deterministic SVG card rendering: A pure-stdlib Python script aggregates the ledger and renders a self-contained 1200x630 SVG card with weekly totals, all-time totals, top-skill bars, and cache-read percentage.
- Multi-artifact output: One run also writes a Markdown report, a dashboard JSON spec, an optional PNG raster (via cairosvg or rsvg-convert), and appends a run log entry.
- Notification delivery: Sends the recap through ./notify with an inline PNG photo on Telegram when available, degrading to a text recap plus SVG link otherwise; supports dry-run mode and custom windows up to 90 days.
- Use Case: An operator running an autonomous agent instance wants a weekly consumption summary to share; the skill reads the instance's own ledger, renders the card, commits the artifacts, and posts the recap to Telegram.
Quick Start
Run the weekly-aeoncard skill with an empty variable to render this week's token-consumption card from memory/token-usage.csv and send the recap notification.