Ohmyclawd

Claude Code usage monitor on ESP32-2432S028R (CYD 2.8") with pixel art animations.

Real-time session + weekly usage. Animated pixel sprites. Digital clock.

Features

- Usage bars — session + weekly utilization at a glance
- 13 pixel sprites — changes based on activity state
- Tmux detection — knows when Claude waiting for input
- OTA updates — checks GitHub releases on boot
- Captive portal config — no code changes for WiFi/daemon setup
- Pixel clock — retro digital clock + second-progress bar
- On-device settings — brightness, quiet hours, auto-cycle, sprite mode, orientation, factory reset
- Page nav — indicator dots +  tap buttons
- Offline indicator — pixel X + colour-drain when unreachable

Hardware

Quick Start

1. Install daemon

Runs on your machine. Polls Anthropic rate-limit headers, serves usage JSON.

Other platforms — Releases:

2. Flash firmware

Browser (easiest): Web Flasher — USB connect, click install.

PlatformIO:

esptool: download ohmyclawd-firmware.bin from Releases:

3. Configure CYD

First boot creates WiFi AP:

1. Connect to OhMyClawd on phone
2. Captive portal opens (or 192.168.4.1)
3. Enter WiFi SSID + password
4. Set Daemon URL (default: http://ohmyclawd.local:8787)
5. Set Daemon Token (must match OHMYCLAWD_TOKEN on daemon)
6. Set Timezone (POSIX TZ format)
7. Save — reboots and connects

Settings persist. Hold 5s to reset, or use RESET row in settings (3s hold).

4. Done

Tap = cycle sprites.  = switch modes.

Sprite States

Requires Claude Code in tmux:

Settings

Reach via swipe or nav buttons (auto-cycle skips settings).

* rows = hold-drag sliders: hold 0.5s → orange bar → drag. Tap SAVE to persist.

SLEEP mode: screen dark. Tap = wake 10s.

Offline: bars + sprite drain grey, pulsing red X top-right. Auto-recovers.

Updates

Firmware:…