CodeMate v1.0.0

First public release. 🎉

CodeMate is a USB desk display for real-time Claude Code / Codex usage — a
Waveshare ESP32-S3-LCD-1.47 board showing your official rate-limit percentages,
context window, work-status LED, a lid-closed terminal screen and a system monitor,
fed by a single ~1 MB tray-resident Windows host.

Assets

File	What it is
CodeMate-firmware-v1.0.0.bin	Complete flash image for the Waveshare ESP32-S3-LCD-1.47: bootloader + partition table + app + the read-only USB-disk filesystem (with the host exe inside). Flash at offset 0x0.
CodeMate.exe	Windows host: tray icon, config window, Claude Code / Codex hooks, serial host — one file.
SHA256SUMS.txt	Checksums for both.

Flash the firmware

1. Put the device in download mode: hold BOOT, tap RST, release BOOT.

2. Flash (pip install esptool if you don't have it):

   esptool --chip esp32s3 --baud 921600 write_flash 0x0 CodeMate-firmware-v1.0.0.bin
   

3. Press RST to boot the new firmware.

Set up the host (Windows)

1. Run CodeMate.exe → a tray dot appears (cyan = device connected, gray = not).
2. In the config window click Install / Repair hooks (or run CodeMate.exe --install).
3. Send one message in Claude Code — the display comes alive.

Requirements: Windows · recent Claude Code signed in with Pro/Max · WebView2
Runtime (preinstalled on Win11) · optional Codex CLI.

Tip: the flashed device also carries CodeMate.exe on its own read-only USB disk
(long-press BOOT → U-Disk) for offline installs on other machines.

Docs: README ·
firmware & flashing ·
protocol & extending