Hardware desktop pets for your AI coding agents
Choose from thousands of characters or create your own in one click
Turn Codex, Cursor, Windsurf, and other agents into live companions across desktop and hardware
English · Protocol · Petdex · 中文 · 日本語
Vibe Pet is a hardware desktop pet project for AI coding agents. It watches live activity from Codex, Cursor, Windsurf, and other AI coding agents in CLIs and IDEs, turns states such as thinking, tool use, waiting for approval, completed, and error into animated pets, then syncs the same state to Wio Terminal or ESP32-S3 hardware over BLE.
- Multi-agent pet view: every active editor or AI coding agent gets its own pet card instead of sharing one combined state.
- Real desktop pets: pets from the main window are also spawned onto the desktop, and each one can be dragged independently.
- Hardware sync: send state over Bluetooth to devices such as Wio Terminal or ESP-AI-MINI AI Dev Kit.
- Character switching: choose a character from Petdex by default or use a custom character you made.
Vibe Pet automatically tries to install or sync integrations for:
| Agent | Integration |
|---|---|
| Codex | Hooks and JSONL session monitoring |
| Cursor | Hooks |
| Windsurf | Cascade hooks |
| Claude CLI | Hooks |
| Claude Code | Hooks |
| Gemini CLI | Hooks |
| Copilot CLI | Hooks |
| CodeBuddy | Hooks |
| Kimi Code CLI | Hooks |
| Qwen Code | Hooks |
| OpenClaw | Plugin |
| opencode | Plugin |
| Qoder | Hooks |
| Hermes Agent | Plugin |
| Reasonix CLI | Hooks |
| Hardware | Display / role | Sync | Adapted | Notes |
|---|---|---|---|---|
| SenseCAP Indicator | 4-inch 480×480 touch display | BLE | ✅️ | ESP32-S3 + RP2040; ST7701S RGB display; LVGL character rendering. |
| Wio Terminal | Main animated pet display | BLE | Ing | Mature BLE animated display target. |
| Vibe Pet | ESP32-S3-based AI dev kit | BLE | ✅️ | TFT target; LVGL character rendering. |
Want to bring Vibe Pet to your own device? The BLE and Wi-Fi hardware payloads are intentionally small, so new screens, status lights, badges, and custom boards can be added without changing the desktop app.
Download the installer for your platform from the Releases page.
- macOS: download the
.dmgor.zipbuild. - Windows: download the
.exeinstaller. - Linux: download the
.AppImageor.debpackage.
After installation, launch Vibe Pet and use the desktop app to connect your device. You can also use Vibe Pet without hardware if you only want the desktop pets.
- Project structure, local endpoints, BLE / Wi-Fi behavior, and hook mapping are documented in AGENT.MD
- Protocol documentation starts at the protocol index
- English protocol docs:
- Chinese protocol docs:
Ideas, bug reports, hardware ports, new agent integrations, translations, and UI improvements are all welcome. If you want to contribute code, read CONTRIBUTING.md for development setup, packaging, testing, and PR guidance.