← all repositories
PC2005-cloud/dsh-pet

A desktop pet that reacts to your AI coding sessions — and your API balance

dsh-pet is a transparent animated pet living inside DeepSeek Harness that naps, wanders, gets flung across your screen, and visibly sulks when your quota runs low.

★6.5k stars TypeScript Coding Assistants
dsh-pet
Velocity · 7d
+525
★ / day
Trend
↗accelerating
star history

What it does

dsh-pet is a plugin for DeepSeek Harness (DSH) that puts a hand-drawn, transparent animated pet on your screen — in the browser overlay or in its own always-on-top Electron window. It idles, breathes, naps, plays with a Rubik’s cube, eats hotpot, wanders within screen bounds, and reacts to clicks and drags with spring physics and squash-and-stretch. It also listens to DSH session events, switching to “thinking / working / success / error” animations, and can show your provider balance as tiered animations with a speech bubble — from “money bag overflowing” down to “penniless.”

The interesting bit

It’s not just a plugin — the repo ships a full three-part pipeline: AI prompt recipes, an asset-generation chain that converts source video into transparent VP9-Alpha animations, and the finished plugin. Anyone can clone it and reproduce their own pet from scratch, with new characters and actions. It also exposes a local HTTP API so other plugins can drive the pet — make it speak, play animations, or read its state — with an OpenAPI spec included.

Key highlights

  • 100+ transparent animations that chain seamlessly with double-buffered cross-fades
  • Multi-instance: several pets on screen at once, each with independent size and position
  • Physics is a set of pure functions (dsh-pet/src/shared/physics.ts) shared between browser and desktop modes — throw it and it bounces off screen edges
  • Reacts to DSH session state; balance tiers for DeepSeek and OpenCode Zen Go, with a clear text notice for unsupported providers instead of silence
  • Cross-platform (Windows/Linux/macOS), multi-monitor aware, headless-Linux tolerant, and respects prefers-reduced-motion

Caveats

  • Safari is unsupported — macOS webm alpha renders as a black background; you need .mov assets from GitHub Releases plus a config change
  • Developed and tested against a specific DSH version (0.2.0-rc.2); other versions may misbehave
  • The HTTP API is localhost-only with no authentication — fine for a desktop pet, but worth knowing before other plugins poke it

Verdict

If you use DeepSeek Harness and want your terminal to have a soul — or you want a reproducible template for building your own animated desktop pets — this is delightfully thorough. If you’re not in the DSH ecosystem, it’s a fascinating reference implementation and little else.

Frequently asked

What is PC2005-cloud/dsh-pet?
dsh-pet is a transparent animated pet living inside DeepSeek Harness that naps, wanders, gets flung across your screen, and visibly sulks when your quota runs low.
Is dsh-pet open source?
Yes — PC2005-cloud/dsh-pet is open source, released under the MIT license.
What language is dsh-pet written in?
PC2005-cloud/dsh-pet is primarily written in TypeScript.
How popular is dsh-pet?
PC2005-cloud/dsh-pet has 6.5k stars on GitHub and is currently accelerating.
Where can I find dsh-pet?
PC2005-cloud/dsh-pet is on GitHub at https://github.com/PC2005-cloud/dsh-pet.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.