vibe-pet
Health Pass
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 14 GitHub stars
Code Fail
- rimraf — Recursive directory removal in package-lock.json
- fs module — File system access in src/desktop/esp-flasher.js
- child_process — Shell command execution capability in src/desktop/main.js
- os.homedir — User home directory access in src/desktop/main.js
- process.env — Environment variable access in src/desktop/main.js
- fs module — File system access in src/desktop/main.js
- network request — Outbound network request in src/desktop/main.js
- process.env — Environment variable access in src/desktop/updater.js
- os.homedir — User home directory access in src/hooks/agent-hook.js
- process.env — Environment variable access in src/hooks/agent-hook.js
- fs module — File system access in src/hooks/agent-hook.js
- network request — Outbound network request in src/hooks/agent-hook.js
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
Agent token and task monitoring, thousands of pet avatars, cross-platform support, and compatibility with popular AI agents. 一眼查看 Token 与任务状态,海量 Petdex 形象可选,支持 Windows/macOS/Linux、ESP/Wio Terminal,兼容 Cursor、Codex、Claude、Windsurf 等主流 Agent。
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 | Ing | ESP32-S3 + RP2040; ST7701S RGB display; LVGL character rendering. |
| 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. |
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
.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.
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:
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.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found