alterhq

alterhq / openpets

Public

One shared macOS desktop pet for AI agents and apps, with MCP/CLI control and Codex Pets support.

openpets.sh ai-agents ai-tools codex macos mcp
15
1
100% credibility
Found May 06, 2026 at 15 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Swift
AI Summary

OpenPets is a macOS menu bar app featuring an animated desktop pet that visualizes task progress, statuses, and notifications from local AI coding assistants via a shared local connection.

How It Works

1
🐱 Discover a desktop buddy

You find OpenPets, a fun animated pet that lives on your Mac desktop to show what your AI coding helpers are doing.

2
📥 Download and install

Grab the app from the latest release and drop it into your Applications folder; it requires macOS 14 or newer.

3
🚀 Launch from menu bar

Click the paw icon in your menu bar to start; it sets up a quiet home for your pet and shares a web address for connections.

4
😍 Wake your first pet

Tap to bring Starcorn to life on your screen; watch it idle cutely, ready for action.

5
🔗 Connect your AI helpers

Follow the easy setup to link coding tools like Codex or Claude; they now send updates through your pet.

6
✨ See tasks come alive

As your AI works, the pet dances for progress, shows bubbly messages for reviews or finishes, and stacks updates neatly.

🎉 One pet for everything

Enjoy your shared desktop companion across all tools, making coding feel playful and visible.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 15 to 15 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is openpets?

OpenPets delivers a single shared macOS desktop pet that visualizes AI agents' progress, review prompts, and task states with lightweight animations. Multiple apps and agents—like Codex, Claude Code, or Cursor—control one pet via MCP server at http://127.0.0.1:3001/mcp, CLI commands (notify, animate, clear), or Swift package APIs, eliminating scattered status UIs. Built in Swift, it supports Codex Pets bundles for custom sprites and installs via releases or CLI.

Why is it gaining traction?

It stands out by unifying feedback across tools into one draggable, always-visible pet, with threaded notifications, action URLs, and states like running/review/done. Devs hook into it fast via MCP tools (wake_pet, notify, play_pet_animation) or CLI scripts, plus menu bar controls for server, config, and pet switching. The shared socket and pet library make it dead simple for local agents to broadcast without per-app windows.

Who should use this?

macOS devs running AI coding agents (Codex, Cursor, Claude Code) who want glanceable task visibility during builds or reviews. Local tool builders integrating status updates via Swift or CLI. Teams sharing one desktop companion for agent/apps workflows, skipping native notifications.

Verdict

Try it if you're on macOS with AI agents—solid for quick visual control, but 15 stars and 1.0% credibility signal early days with basic docs and tests. Promising niche tool; watch for plugin ecosystem and richer states.

(187 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.