KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

vibe-pet

★ 42 Open GitHub ↗

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。

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

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
 ·
 <a href="docs/protocol.md">Protocol</a>
 ·
 <a href="https://github.com/crafter-station/petdex">Petdex</a>
 ·
 <a href="README.zh-CN.md">中文</a>
 ·
 <a href="README.ja-JP.md">日本語</a>

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](https://github.com/crafter-station/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](https://wiki.seeedstudio.com/Sensor/SenseCAP/SenseCAP_Indicator/Get_started_with_SenseCAP_Indicator/) | 4-inch 480×480 touch display | BLE | ✅️ | ESP32-S3 + RP2040; ST7701S RGB display; LVGL character rendering. |
| [Wio Terminal](https://www.seeedstudio.com/Wio-Terminal-p-4509.html) | Main animated pet display | BLE | Ing | Mature BLE animated display target. |
| [Vibe Pet](https://espai.fun/open/pcb/mini-ext/1.0.0/) | 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](https://github.com/Seeed-Solution/vibe-pet/releases).

- 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:

```bash
xattr -dr com.apple.quarantine "/Applications/Vibe Pet.app"
```

If needed, re-sign locally:

```bash
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](AGENT.MD)
- Protocol documentation starts at the [protocol index](docs/protocol.md)
- English protocol docs:
  - [IDE / Agent protocol](docs/ide-protocol.md)
  - [hardware protocol](docs/hardware-protocol.md)
- Chinese protocol docs:
  - [IDE / Agent 协议](docs/ide-protocol.zh-CN.md)
  - [硬件协议](docs/hardware-protocol.zh-CN.md)

## 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](CONTRIBUTING.md) for development setup, packaging, testing, and PR guidance.

vibe-pet

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README