mu-pet
by samskrta
Coding Agents & IDEsBrief
Animated pixel art desktop pet that roams the screen as an always-on-top Electron overlay.
Description
What This Skill Does
A pixel art desktop pet that runs as a transparent, always-on-top Electron overlay on macOS. The pet roams the screen, climbs walls and ceilings, avoids the cursor and active windows, and exposes a local HTTP API on port 18891 so agents can change its animation state programmatically.
Unlike static widgets or notification popups, the pet gives continuous ambient visual feedback about agent state without interrupting focus or requiring window switching.
When to Use It
- Visual indicator when an AI agent is running a long task
- Desktop companion during extended coding or writing sessions
- Mascot that shows thinking or working states during agent activity
- Auto-launching startup buddy configured via macOS LaunchAgent
- Screen element with speech bubbles driven by agent curl calls
Example Workflow
User asks: 'Run a long analysis task and keep me updated'
- 1
Start the pet with 'npx electron .' in the skill app directory
- 2
POST /state with {"state":"working"} when the task begins
- 3
POST /state with {"state":"thinking"} while reasoning
- 4
POST /state with {"state":"talking","bubble":"done!"} when ready to report results
Pet animates through working, thinking, and talking states, then auto-returns to idle
Installation
clawhub install samskrta/mu-petRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.