Claude Monitor Esp32

Claude Code Monitor - ESP32 Notification Device

Get instant alerts when Claude Code needs your attention! 🚨🚨🚨

A physical notification device using MicroPython on ESP32 that displays Claude Code status on an OLED screen and alerts you with sound.

What Is This?

Never miss when Claude Code needs your input! This device:
- 📺 Displays Claude Code status on an OLED screen
- 🔔 Beeps when Claude Code needs your input
- 💡 Optional red LED flashes when waiting (visual indicator)
- 🔗 Automatically integrates with Claude Code via hooks
- 🌐 Provides a web interface for testing
- 📡 Works over your local WiFi network

Why MicroPython? (and not plain c)

-  Easier to install - No compilation needed
-  Easier to modify - Edit Python files directly
-  Remote updates - Update code over WiFi (WebREPL)
-  Interactive - Test code in real-time REPL
-  Better debugging - See errors immediately
-  Familiar - If you know Python, you already know 90%

Hardware Required

Minimal setup (~$15-25):
- ESP32 development board
- SSD1306 OLED display (128x64, I2C)
- Piezo buzzer
- Breadboard and jumper wires
- USB cable

Optional:
- Red LED (5mm) + 220Ω resistor - Visual WAITING indicator

I got mine from Aliexpress, you can buy a kit for like 12$, here an example (not affilated) - https://a.aliexpress.com/_c38apGy3
And I also like using a Terminal adapter (30p) which isn't included in the kit (around 2$)

Wiring Diagram

Visual Wiring

🚀 Quick Start

Step 1: Flash MicroPython (5 minutes)

Step 2: Install Thonny IDE (2 minutes)

1. Download from: https://thonny.org
2. Install and open Thonny
3. Configure: Tools → Options → Interpreter
4. Select "MicroPython (ESP32)" and your COM port

📘 Need detailed help? See the complete Thonny IDE Guide

Step 3: Upload Files (3 minutes)

1. Edit…