Claude Dashboard Trmnl

Claude Code Dashboard → TRMNL

Full dashboard for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) on a [TRMNL](https://usetrmnl.com) e-ink display. Rate limits, extra usage billing, costs, sessions, cache efficiency, streak — powered by [iii-engine](https://iii.dev).


What's on the Dashboard

• Extra Usage — real Anthropic billing ($42.30 / $50 limit, 84%)
• Rate Limits — session % and week % with reset times
• Cost Tracking — today, week, month, all-time (per-model pricing from Claude Code source)
• Token Breakdown — input, output, cache read, cache write, total
• Sessions — running, today, week, month, total, streak days, hours coded
• Efficiency — API equiv. cost, messages, cache hit %, cost/req, cache savings
• Model Usage — primary model badge, conditional sonnet/haiku when used
• Setup — plugins, MCPs, projected monthly cost

4 layout sizes: full, half vertical, half horizontal, quadrant.

Architecture

Two setup options — iii worker (recommended) or launchd fallback.

Option 1: iii Worker (Recommended)

The iii worker registers functions and cron triggers against a running iii-engine. Real-time cost tracking via `chat::completed` events, cron-based TRMNL posting, state persistence in iii KV.

iii-engine (ws://localhost:49134)
  └─ claude-dashboard-trmnl worker
       ├─ trmnl::refresh          [cron 5min] → parse sessions + scrape /usage + POST webhook
       ├─ trmnl::on_chat_completed [subscribe] → real-time cost tracking in iii state
       ├─ GET  /api/trmnl/health   [http] → last update status
       └─ POST /api/trmnl/refresh  [http] → manual trigger
                                     ↓
                               TRMNL webhook → e-ink display

Option 2: launchd (macOS fallback)

Python scripts scheduled via macOS launchd. No iii-engine required.

launchd (every 5 min) → run.sh → Python scripts → POST webhook

Pr