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
-
Put the device in download mode: hold BOOT, tap RST, release BOOT.
-
Flash (
pip install esptoolif you don't have it):esptool --chip esp32s3 --baud 921600 write_flash 0x0 CodeMate-firmware-v1.0.0.bin -
Press RST to boot the new firmware.
Set up the host (Windows)
- Run
CodeMate.exe→ a tray dot appears (cyan = device connected, gray = not). - In the config window click Install / Repair hooks (or run
CodeMate.exe --install). - 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