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

ESP32 Pin Connections:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

SSD1306 OLED Display (I2C):
  VCC  →  3.3V (ES