harmlessfunny/dsh-pet-in-frame

A desktop pet in the DSH web GUI that reacts to what the agent is doing; drop images into assets/ and it changes without a rebuild.

Floats a small desktop pet in the corner of the DSH web GUI that reacts to what the agent is doing — thinking, searching the web, reading code, running commands, editing files, hitting an error or idling — driven by the host half listening to the agent lifecycle and the browser half polling state and swapping poses.

Just for Fun ★ 0
View on GitHub ↗

Install

dsh plugin --profile web add dsh-pet-in-frame

One package is one bundle and one loader row. Restart the dsh web process after installing — new bundle entries load at boot — and refresh the page so the browser bundle loads. A local path and a commit-pinned GitHub form are also documented. If you previously pointed a dynamic plugin at an assets directory, copy those files into the package's assets/ folder or set DSH_PET_ASSETS, because after install the assets directory is the source of truth.

Compatibility

The interesting design decision is that the assets directory is the config: drop bash.png into assets/ and the pet shows it whenever a command runs, add a frame list plus one manifest.json line and you get an animation, with a hot reload in three to four seconds and no rebuild or code change. Idle sleep starts after 30 seconds of continuous idle and clicking the pet wakes it. The pet is process-wide: this is a host-plane plugin, so events from every session feed the same pet, which is fine for a single-user deployment. Security boundaries are stated: only the configured assets directory is served, filenames must match a word-and-dot whitelist so there is no path traversal, the manifest is parsed and treated as data only, and routes are read-only GETs except POST /wake, which only resets a timer. Frame animation is flipbook-style, so many frames are better served by a single sprite or GIF.

Details

Alternatives

allenyu0118/dsh-client-ui-whale · zuoyunlai/dsh-pet-plugin · nzl153/dsh-pet-whale

More plugins in Just for Fun

Browse more in Just for Fun

Guides for Just for Fun plugins