Un robot de escritorio que te cuenta qué se está vibecodeando.

por Saramia y Tais

CodeBuddy es un pequeño ESP32 con cara de pantalla OLED. Mira trabajar a Claude Code y explica cada cambio con palabras simples, en la pantalla y en voz alta.

Ármalo en una tarde

Narra cada paso

Los hooks de Claude Code le mandan cada evento al robot por WiFi o Bluetooth. Una llamada corta a la API de Claude lo convierte en una frase amigable.

Mandas un prompt"¡Manos a la obra!" y luego una frase sobre lo que se va a construir.

Leyendo y ejecutando"Echando un vistazo a auth.ts…", "Corriendo los tests"

Código editadoEl archivo, +12 −3 y qué hace de verdad el cambio.

Necesita permisoCara de alerta: "¡Psst! Claude necesita tu permiso para usar Bash"

TerminóCara feliz, ¡listo! 3 archivos +40 −9 y qué revisar.

10 minutos sin actividadCara de sueño. zzz.

Claude Code hooks ──► buddy-notify ──► WiFi / Bluetooth ──► ESP32 + OLED
                       ├─► narrate.py ──► Claude API ──► "¡Agregando un límite de intentos para que nadie spamee el login!"
                       └─► la voz de tu compu lee cada frase en voz alta

ESP32 conectado a una pantalla OLED en una protoboard

Cuatro cables

Un ESP32 DevKit, una OLED I²C de 0.96" o 1.3", una protoboard y cuatro cables jumper.

OLED	ESP32
GND	`GND`
VDD	`3V3`
SCK	`GPIO 27`
SDA	`GPIO 26`

¿SDA y SCK al revés? El firmware lo detecta y funciona igual.
¿Ruido o estática en la pantalla? Es una SH1106: flashea con -e sh1106.

Configúralo

Solo se flashea una vez. Después el robot solo necesita corriente por USB y WiFi, y cualquier Mac o Linux en esa red puede controlarlo.

Pon tu WiFi
Edita firmware/include/secrets.h. Usa una red de 2.4 GHz, la misma de tu compu.
Flashéalo
Conecta el ESP32. Si se queda en "Connecting…", mantén apretado BOOT.
```
cd firmware
pio run -e ssd1306 -t upload && pio device monitor
```
Instala el puente
Conecta los hooks de Claude Code, la barra de estado, la voz y el comando remind, y saluda a través del robot.
```
./install
```
Dale voz
Pon una API key de Anthropic en bridge/config.json para las explicaciones con IA. Sin key igual usa sus frases incorporadas.

Además

Habla en voz alta

Piper te da la misma voz offline en todas tus compus; si no, usa say de macOS. También habla español y portugués.

Cuenta tokens

Muestra tokens y costo después de cada tarea. Te avisa cuando los límites de tu plan pasan el 50%, 80% y 95%.

Recordatorios

remind en 20m estirar la espalda pone la cara de alerta, lo dice en voz alta y manda una notificación.