deepseek-harness-pet: A Desktop Pet Animation DSH plugin for DeepSeek Harness
minybear/deepseek-harness-pet
A DSH plugin that adds a desktop pet driven by agent state.
Display an animated pet in the bottom-right corner of the DeepSeek Harness Web GUI, driven by agent state, making waiting for tasks more fun.
dsh plugin --profile web add github:minybear/deepseek-harness-pet- Category
- Entertainment
- Platform
- DSH-Plugin
- Author
- minybear
- Distribution
- Plugin
deepseek-harness-pet Key Features
deepseek-harness-pet Repository
deepseek-harness-pet Repo Summary
deepseek-harness-pet is a desktop pet plugin (DSH plugin) for DeepSeek Harness, maintained by minybear under the MIT license, last updated in 2026-08. It replicates the Pets feature from OpenAI Codex desktop, floating an animated pet in the bottom-right corner of the DSH Web GUI, driven in real-time by the current session's agent running state, adding a touch of fun while developers wait for tasks. Core capabilities include: registering into the shell.overlay slot as a frame-level floating layer (click-through, draggable); mapping DSH signals (like running, pendingInteraction, lastAgentError) to Codex's 9-state animation rows, covering working, waiting for input, error, done, and idle scenarios; clicking the pet pops up a menu for feeding and playing, with adjustable size (0.5–1.5) and opacity (0.2–1), and both position and appearance settings persist to localStorage. The pet format is compatible with Codex's pet.json and row-major spritesheet; the built-in default pet is generated at runtime via canvas.
What core features does the deepseek-harness-pet DSH plugin support?
This plugin offers four main features: floating pet, state-driven animation, interaction menu, and appearance settings. State-driven animation is its highlight: DSH's running === true triggers the running row, pendingInteraction triggers waiting, lastAgentError triggers failed, the falling edge of running (true→false) triggers jumping (about 2.6s), completed without selection triggers review, and no activity returns to idle. For interaction, clicking pops up a menu (feed, play, settings), and dragging moves the pet with position persisted. Appearance settings include size and opacity, also persisted to localStorage.
How to install deepseek-harness-pet?
Use the following install command. After installation, restart dsh web and refresh the page; the pet should appear in the bottom-right corner. Note that client plugins require host-side bundling (dsh.client.inject) to take effect.
dsh plugin --profile web add github:minybear/deepseek-harness-pet
What are the pet format and code structure of deepseek-harness-pet?
The pet is described by pet.json (containing id/displayName/description/spritesheetPath/frame/animations) plus a row-major spritesheet, with frame index computed as index = row×columns + col. The first 9 rows are the official Codex V1 9 states, and rows 9–11 are interaction states (eat/play/drag). The code structure is clean: lib/pet-core.js is pure logic (Node-testable), lib/client.js handles browser-side loading and rendering, and test/ contains Node unit tests.
Which DeepSeek Harness versions and platforms are compatible with deepseek-harness-pet?
This plugin targets the DSH Web GUI, depends on @deepseek-ai/dsh-client-runtime and @deepseek-ai/dsh-client-ui-slots, and registers via the official dsh.bundle manifest. The repository was created on 2026-08-14, currently with 2 stars and 0 forks, an early but feature-complete fun plugin.