// readme

VibeBuddy

English | 简体中文

VibeBuddy is a desk pet for your AI coding agents. It lives in a small ESP32-S3 box next to your keyboard and keeps an eye on Codex, Claude Code, OpenCode, GitHub Copilot CLI, Pi and your GitHub Actions runs, so you don’t have to. When an agent needs you, finishes, or fails, the buddy tells you with an animation, a task card and a short spoken line.

The buddy is an original character. Codex was the first agent it supported, but the device protocol isn’t tied to any one client: any local program or script can send it events.

(The project used to be called VibeBuddy; the repository, the vibebuddyd daemon and the VibeBuddy Protocol keep that name.)

Rather not build one? A ready-to-use VibeBuddy, assembled, flashed and tested, is in stock at vibekeys.dev. Everything it runs is the open-source code in this repository.

On the box

Screen captures from a real box running the Rust firmware. Status scenes use example task names and daily stats; Pomodoro scenes show the live…