A desktop companion for macOS and Windows, AgentPet visually monitors multiple AI coding agents (Claude Code, Codex, Cursor, Gemini) in real-time. It targets developers seeking to reduce tab-hunting and gain at-a-glance awareness of agent status, offering an ambient interface that grows alongside user coding activity.

How It Works

The core approach combines a menu bar monitor for detailed agent states (running, done, waiting) with a desktop pet that reacts ambiently. Integrations use specific hooks or a universal agentpet run -- <command> wrapper. Agent usage (tokens, sessions) fuels a gamified pet system, earning XP, levels, and evolutions.

Quick Start & Requirements

• macOS: Install via Homebrew (brew install --cask ntd4996/tap/agentpet) or download DMG from Releases. Requires macOS 13+ (14+ recommended); Apple Silicon/Intel supported. Source build needs Xcode 16 / Swift 6.
• Windows: Download installer/portable build from releases. Requires Windows 10/11 (64-bit). Early builds may trigger SmartScreen warnings.
• General: Auto-updates are included.

Highlighted Details

• Real-time multi-agent status via menu bar monitor and desktop pet.
• Gamified pet progression (XP, levels, evolution) fueled by agent activity.
• Stats HUD displays pet stats, usage charts, and subscription limits.
• Optional GitHub integration for web profile and community leaderboard.
• One-click pet library browsing (Petdex format).
• Universal CLI agent wrapper.

Maintenance & Community

Primary developer: Nguyễn Thành Đạt (@ntd4996). Community ports for Linux exist separately. Pet assets use the Petdex format/API.

Licensing & Compatibility

Application code is MIT licensed, permitting commercial use. Pet assets have separate licenses.

Limitations & Caveats

Primary application is macOS-native; community ports exist for Linux. Windows build is an early, unsigned release. Some agents lack "needs input" state reporting. Source builds require specific, potentially new, Xcode/Swift versions.