aibo

English ｜ 简体中文

あいぼう，エージェント走らせるぜ！

Native macOS desktop companion.

Stays perched on your desktop, broadcasting two types of info via speech bubbles:

1. Local AI Agent Status: Real-time thinking, tool calls, and completion events from Cursor, Codex, etc. via hooks.
2. 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.