aibo
English ｜ 简体中文
あいぼう，エージェント走らせるぜ！
Native macOS desktop companion.
Stays perched on your desktop, broadcasting two types of info via speech bubbles:
- Local AI Agent Status: Real-time thinking, tool calls, and completion events from Cursor, Codex, etc. via hooks.
- Remote Webhook Notifications: Deployment status, CI results, etc. (requires your own tunnel).
Features
- Native app without heavy helper processes hogging system resources.
Enjoy authentic SwiftUI stutters
- Supports PetDex V1/V2 assets.
- Install from a local static image, or a
.zip of V1/V2 assets.
- Handy little extras:
- Webhook received logs
- Music notes when the system is playing audio
- Pixel-art sprite display optimization
- Slice spritesheets to keep resident resources down
- Minimalist extension
Roadmap
View here
Skills
- hatch-aibo: a rework of the original
hatch-pet skill for more controllable sprite quality
- aibo-webhook: how to send webhook messages to aibo
Structure
App/ Desktop UI (panel, bubbles, settings)
AiboKit/ Core logic and tests (events, hooks, webhook)
Hook/ aibo-hook CLI
Skills/ Agent skills
Scripts/ Build and launch
Requirements
macOS 26 or later.
Install
Download Aibo-*.dmg from Releases, open it, and drag aibo.app into Applications. Do not keep running it from Downloads — in-app updates need the app to live in /Applications.
Contributing
This project does not accept Pull Requests.
Feel free to open an Issue for feedback or ideas, or fork and hack on it in your own repository.
When forking, consider generating an AGENTS.md first and develop with your preferred workflow. For example:
- "Help me adapt Claude Code hook messages"
- "Help me adapt this to macOS 15 and earlier"
- "Help me adapt this to Linux"
Build
# Core logic tests
cd AiboKit && swift test
# Build app
xcodebuild -project aibo.xcodeproj -scheme aibo -configuration Debug build
# Build and launch
./Scripts/run.sh
Acknowledgments
This project is inspired by AgentPet, an excellent native desktop pet app that includes some online services.
