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
Wio Terminal	Main animated pet display	BLE	Ing	Mature BLE animated display target.
ESP-AI-MINI AI Dev Kit	ESP32-S3-based AI dev kit	BLE	Ing	TFT target; LVGL character rendering.
ESP-AI v3 Dev Board	ESP32-S3-based AI dev kit	BLE	Ing	TFT target; LVGL character rendering.
ESP-AI v4 Dev Board	ESP32-S3-based AI dev kit	BLE	Ing	TFT target; LVGL character rendering.
M5Stack CoreS3	ESP32-S3 color touch display	BLE	Ing	M5Unified ESP32-S3 target.

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.

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:
  • IDE / Agent protocol
  • hardware protocol
• Chinese protocol docs:
  • IDE / Agent 协议
  • 硬件协议

Sponsor

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.