Vibe Pet
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.
Highlights
- 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.
Supported Agents
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 |
Supported Hardware
| 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 and Install
Download the installer for your platform from the Releases page.
- macOS: download the
.dmg or .zip build.
- Windows: download the
.exe installer.
- Linux: download the
.AppImage or .deb package.
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.
FAQ
macOS says “Vibe Pet” is damaged and can’t be opened
This is a Gatekeeper block (unsigned or not notarized build), not a runtime crash. Remove the quarantine attribute and try again:
xattr -dr com.apple.quarantine "/Applications/Vibe Pet.app"
If needed, re-sign locally:
sudo codesign --force --deep --sign - "/Applications/Vibe Pet.app"
Technical Documentation
- 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:
Contributing
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.
评论