Skip to main content

DeepSeek-Harness-Pet

6Stars0Forks0Issues0Watchers

A floating pet in the bottom-right corner of the DSH Web GUI that switches its animation in real-time based on the current session status: running, waiting, error, or completed.

Evidence5/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki
Language
JavaScript
License
MIT
Branch
main
codexdeepseek-harnessdesktop-petdshdsh-pluginpettamagotchi

Install

cmdweb profile
$ dsh plugin --profile web add github:minybear/DeepSeek-Harness-Pet

Run the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial

Install via your agent

Install the DeepSeek Harness plugin minybear/DeepSeek-Harness-Pet for me: review the repository at https://github.com/minybear/DeepSeek-Harness-Pet first, then run the install command and verify the plugin loads successfully.

Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.

Quick Summary

Raise a floating pet in the bottom-right corner of the DeepSeek Harness (DSH) Web client—the pet's animation, status bubbles, and nurturing stats are real-time linked to the agent's running state in the current session: when the agent is working, it runs on gears; when waiting for your input, it raises its hand asking for action; when it crashes during runtime, it rolls its eyes and lies flat.

Core Features

  • Real-time mapping of agent status to 9-segment official animations: running while working, raising hand when waiting for input, lying flat on error, celebratory jump right after completion, waving hello when switching sessions
  • 5 built-in pets available: Dee (teal green), Amber (amber), Berry (berry purple), Gray Whale (DeepSeek Harness logo shape), Blue Whale (DeepSeek official brand blue shape)
  • Nurturing stats system: 🍖 Fullness / 😊 Mood 0–100, decays in real time (even with browser closed), feeding +30, playing +25; automatic prompt when either stat drops below 20 in idle state
  • Click to pop up 🍗 Feed / 🎾 Play / ⚙ Settings menu; drag to move position (position persisted to localStorage); size 0.5–1.5, transparency 0.2–1 fully adjustable
  • Support importing official Codex pet packs (pet.json + atlas), validated and stored to localStorage, can switch or delete anytime
  • Follows system "reduce motion" preference or manual lock, shows fixed idle first frame when enabled
  • Built-in bridge mode: POST session state to http://127.0.0.1:8765/pet-state for desktop client dsh-pet-desktop floating window consumption

Technical Implementation

  • Language: JavaScript (ESM)
  • Key Dependencies: @deepseek-ai/dsh-client-runtime ^0.1.0-rc.6、@deepseek-ai/dsh-client-ui-slots ^0.1.0-rc.6、@deepseek-ai/cordis ^4.0.1、react ^18.2.0
  • Architecture Pattern: Dual-end injection—host side lib/index.js is empty apply (placeholder registration), browser side loaded via package.json#dsh.client.inject exporting exports["./client"], loaded by window.__ModuleLoader__; writes ui-pet to browser roster via cordis.patch.yml; injects two components to shell.overlay slot at runtime: PetOverlay (visible pet) and BridgeOverlay (no-UI state bridge)
  • Entry Files: lib/client.js (browser main), lib/index.js (host side empty placeholder), lib/pet-core.js (DOM-free pure logic layer, state machine + pet.json parsing + frame index + decay)

Use Cases

Users who spend long time staring at DSH Web waiting for agent tasks, wanting some companionship on their work interface. Suitable for those who find logs boring and want to judge the agent's current state at a glance through the pet's movements; not suitable for scenarios requiring serious backend monitoring or maximizing screen space (pet occupies bottom-right floating layer by default, can be dragged away but cannot be completely hidden).

Prerequisites & Compatibility

DependencyMin VersionDescription
DSH (dsh-client-runtime)^0.1.0-rc.6Declared by peerDependencies, pnpm will fetch corresponding host version during installation
DSH client UI slots^0.1.0-rc.6Same as above
@deepseek-ai/cordis^4.0.1DSH internal plugin framework
react^18.2.0Pet UI rendered with React
PlatformCross-platformOnly requires DSH Web GUI with modern browser support; no native module dependencies
Node.jsNot declaredPackage does not declare engines; test scripts use node test/*.mjs, but end users don't need local Node

Installation

dsh plugin --profile web add github:minybear/DeepSeek-Harness-Pet

Configuration Options

OptionTypeDescriptionDefault
PetDropdown selectOne of 5 built-in pets + user-imported custom petsDee (teal green)
SizeSlider 0.5–1.5Overall scale multiplier of the pet0.9
TransparencySlider 0.2–1.0Overall opacity of pet and bubbles1.0
AnimationDropdown selectFull animation / Reduce motion / Auto (follows system prefers-reduced-motion)Auto
Feed / PlayOne-time actionClick menu 🍗 / 🎾 to execute immediately, triggers 2.2s / 2.6s interaction animation and restores nurturing stats—
PositionDragDrag pet to any screen position, persists after refreshBottom-right (16px from edge)

FAQ

Q: Didn't see the pet after installation?

A: Client plugins require host-side packaging and take effect after restarting dsh web. After installation completes, you must restart the dsh web process and refresh the page (default http://127.0.0.1:3080) for the pet to appear in the bottom-right corner.

Q: Do I need to write code or configuration separately?

A: No. The plugin uses the built-in teal green pet Dee by default, ready to use out of the box; size, transparency, animation mode, and pet selection are all adjustable through the settings panel, no config file editing needed.

Q: Can I switch to my own pet?

A: Yes. The settings panel provides "Import Codex Pet Pack", provide manifest file and atlas images (PNG/WebP/GIF, <2MB) in official pet.json format to import, after validation passes it's stored to localStorage, can switch or delete anytime.

Q: Will the pet starve if I close the browser?

A: Yes. Fullness and mood stats decay by wall clock time (≈8 hours / 6 hours to zero), continues timing even when browser is closed, after reopening values are calculated from last update timestamp.

Q: Where is data stored? Does it sync to cloud?

A: All stored in browser localStorage (dsh-pet:* namespace), including pet selection, position, size, nurturing stats, imported custom pets. This plugin does not send any network requests (unless dsh-pet-desktop desktop floating window is also installed, then pushes state to local 127.0.0.1:8765).

Q: What does "reduce motion" mean? What happens to the pet when enabled?

A: Reduce motion mode (system settings or this plugin's settings panel) fixes the pet displaying the first frame of idle animation, no motion playback. This is standard response to system prefers-reduced-motion, helps users with motion sickness use DSH.

Q: Can I hide the pet but keep it installed?

A: Cannot directly "hide", but can set transparency to 0.2 or drag to screen corner; to completely remove please use dsh plugin --profile web remove @minybear/dsh-pet to uninstall.

Q: What's the difference between the five pets?

A: Three blob-style pets (Dee/Amber/Berry) share the same 12-frame walk/wave/jump/lie down animations, only colors differ; two whales (gray whale/blue whale) are side-view, bubbles appear while working, water spray in idle, chest fin raises during wave, overall mirrored for direction.

Difficulty Level

Beginner — install and use immediately, no code writing or config editing; advanced players can import custom Codex pet packs or adjust transparency/size/animation strategy.

Known Issues & Limitations

  • Current version has no active TODO/FIXME; historical issues (such as React hooks order violations, pet-core and client inline copy state machine divergence, install script hardcoded paths) all fixed in versions 0.2.0/0.4.0
  • Custom pet atlas size limit ~3MB (including base64 encoding), imports rejected when exceeded with prompt "Please use WebP/PNG under 2MB", compress with ImageOptim etc. before importing
  • Only 9-line Codex V1 official atlas can enjoy full state machine animation; custom pets lacking interaction rows (eat/play/drag) fall back to idle row during interaction
  • BridgeOverlay bridge mode enabled by default, sends requests to http://127.0.0.1:8765/pet-state; if no companion desktop floating window running, requests are silently dropped but visible in DevTools Network panel

Read the usage guide →

Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.

Listing badge

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/minybear/DeepSeek-Harness-Pet)

Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.

← Back to plugin directory