paseo.cafe
All plugins

paseo-mascot

by sting8k

A koboyo page-mascot pet for the Paseo composer

v0.1.0 Requires Paseo >=0.8.0

Gallery

Install

npmjs · Paseo 0.9+

paseo plugin add npm:paseo-mascot@0.1.0

GitHub · Paseo 0.8 fallback

paseo plugin add sting8k/paseo-mascot --ref 043e7c871b38b191fe43ec91b2e335a450040792

Git security status and fallback installation are pinned to commit 043e7c871b38.

README

paseo-mascot

A pet for your Paseo composer. Pick one of 58 characters from koboyo's page-mascot catalogue and it perches on the chat box, watches what you're doing, naps when you leave, and reacts when you poke it.

Desktop only — it perches on the host's DOM, and the mobile app has none.


⭐ Showcase

Perched on the chat box, watching the cursor Left alone for 10s — asleep until you're back
Left click to poke Four fast pokes, or a long throw
Right click: 58 characters and a name tag

📦 Install

paseo plugin add sting8k/paseo-mascot

Then open Command Center and run Mascot: add a mascot to this composer. paseo plugin update paseo-mascot pulls new versions.


🐾 Using it

Do Gets
Right click picker: choose a character, give it a name
Left click poke — heart / sparkle / delighted in turn; four fast pokes → dizzy
Drag carry it anywhere; the spot is remembered. Drop it back near the chat box and it climbs on
Drag far (≥ 240px) lands dizzy; a short move lands bashful
Park the cursor on it 2s bashful
Leave it 10s falls asleep; wakes surprised when you move or type

On its own it watches the chat box while you type, glances at the transcript while an agent runs, notices the cursor only when it darts or moves somewhere new (and loses interest after a moment), blinks, and now and then pulls a face for no reason.

Workspace status shows too: sparkle when a run starts, delighted when it finishes (held until you come back), surprised when it needs you, dizzy when it fails.


🛠️ Development

npm install
npm run typecheck
paseo plugin reload paseo-mascot   # hot-swaps the plugin in the running daemon

🙏 Credits

Characters, sprite sheets and the original cursor-following behaviour are from page-mascot by Kamran Ahmed (MIT), served from koboyo.com.

📄 License

MIT

Scanned 01 Oct 2026, 18:42 UTC from sting8k/paseo-mascot.