nzl153/dsh-pet-whale
Desktop pet drawn from the official whale outline: pure-SVG animation follows agent state (thinking, working, celebrating, error), with poke and double-click flip interactions, cursor avoidance, 7 palettes, light/dark theme sync, and a playable web preview.
pet-whale is a desktop pet for DeepSeek Harness: a small whale floats in the bottom-right corner and reacts to your agent's state in real time. State machine: idle / think (diving) / working (swimming + typing + code particles) / celebrate (leaping + bubbles) / error (shaking + black lines) / disappointed (after an error) / wait. Interactive states: poke it enough → sulks; shake → dizzy; belly up; squash against the bottom edge; multi-session badge (other sessions running); all done celebration. Pure DOM animations, zero runtime third-party dependencies, WebAudio-synthesized sound effects (no audio files). Live preview page at nzl153.github.io/dsh-pet-whale/preview.html tests every state without DSH.
Install
dsh plugin --profile web add pet-whaleThe npm package pet-whale 1.2.6 was re-verified live on 2026-10-01 with its repository field back-linking to nzl153/dsh-pet-whale. The README also documents a git form ('dsh plugin --profile web add "github:nzl153/dsh-pet-whale#main"') and a local-directory form with a link: install. Requires DSH >=0.1.5-alpha.2 <0.3.0 and Node.js ^22.19.0 || >=24.0.0.
Compatibility
DSH >= 0.1.5-alpha.2 < 0.3.0; Node.js ^22.19.0 || >=24.0.0. Works in both the desktop app and the web UI. Pure DOM animations, zero runtime third-party dependencies, WebAudio-synthesized sound (no audio files). Uses the official DeepSeek whale outline.
Details
- Repo: nzl153/dsh-pet-whale
- Category: Just for Fun
- Stars: 0
- Version: npm pet-whale 1.2.6 (registry re-verified 2026-10-01); MIT
- Last push: 2026-09-19
- First seen: 2026-08-14
Recent updates
The README documents the full state machine, the interactive states (sulk, dizzy, belly up, squash), the multi-session badge, the live preview page, and the community forks section. The README carries compatibility-check details per release.
FAQ
- How do I install pet-whale?
- dsh plugin --profile web add pet-whale (npm 1.2.6 re-verified 2026-10-01); requires DSH >=0.1.5-alpha.2 <0.3.0.
- Can I try it without installing?
- Yes — the live preview at nzl153.github.io/dsh-pet-whale/preview.html loads the real plugin and feeds it state from buttons.
- Does it play audio?
- Yes — WebAudio-synthesized sound effects, no audio files downloaded, per the README.
Alternatives
swaylq/dsh-digipet · Gin-7/dsh-pet-remielle · moononnn/DeepSeek-Harness-biaoqingbao