desktop-pet

name

desktop-pet

description

Animated pixel art desktop pet that roams the screen as an always-on-top Electron overlay. The pet avoids the cursor and active windows, walks along screen edges, climbs walls and ceilings, and responds to agent state changes via a local HTTP API. Use when a user wants a desktop companion, screen buddy, desktop mascot, virtual pet, or visual indicator of agent activity. Supports states like idle, walking, working, thinking, sleeping, and talking (faces user with speech bubble). macOS only.

Desktop Pet

A pixel art desktop pet (default: lobster 🦞) that roams the screen as a transparent Electron overlay.

Quick Start

cd <skill-dir>/assets/app
npm install
npx electron .

The pet starts at the bottom center of the screen and begins roaming.

HTTP API

Local API on port 18891 (127.0.0.1 only):

• GET /state - returns {"state":"idle","statusText":""}
• POST /state - set state: {"state":"talking","bubble":"hello!"}

States

State	Behavior
idle	Gentle bob, occasional claw snap
walking	Moves along current surface
climbing	Transitions between floor/walls/ceiling
fleeing	Running from cursor or active window
working	Sits at tiny laptop with sparkle particles
thinking