dsh-desktop-pet DSH plugin

dsh-desktop-pet is a DeepSeek Harness plugin that displays a small animated pet on your desktop. The pet reacts to the harness's state: it relaxes when idle, 'thinks' during reasoning, 'works' while tools run, and celebrates or frowns when a turn finishes. It is not a chat UI or task manager, but a pure status indicator.

ui-productivity

How to install the dsh-desktop-pet DSH plugin

dsh plugin --profile <name> add dsh-desktop-pet

This source command needs manual review. Copying does not run it.

dsh-desktop-pet DSH plugin data source

dsh-desktop-pet DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-desktop-pet DSH plugin can do

Displays animated pet that reflects harness status (idle, thinking, working, waiting, success, error, sleeping)
Zero network usage: all assets bundled, no telemetry or CDN
Zero added LLM cost: state transitions are deterministic, no model calls
Runtime discovery of pets: drop a folder into assets/pets/ to add a new pet without rebuild
Configurable via settings card: enable/disable, scale, pet selection, hide-when-idle, animation speed, etc.
Supports Windows 11 (primary) and Linux X11 with compositor; macOS not implemented
Developer mode with /pet command to simulate states without LLM

Where the dsh-desktop-pet DSH plugin fits

Visual feedback when the harness is processing a task, e.g., the pet 'thinks' during reasoning
Ambient awareness of the harness's activity without checking a terminal or browser
Fun desktop companion that reacts to different tool execution phases
Add a custom pet by dropping a folder into the assets directory
Test state transitions in isolation using the developer command

Who the dsh-desktop-pet DSH plugin is for

DeepSeek Harness users who want a visual desktop indicator of harness activity
Users who enjoy desktop customization and want an animated pet as a status light

dsh-desktop-pet DSH plugin limitations

Linux transparency requires a compositor (e.g., picom); on Wayland the pet runs as an XWayland client, not native wlr-layer-shell
macOS is not implemented
Bundled placeholder is only a text-based test pet, no official character artwork
Native window rendering (frameless, transparent, topmost, drag) has not been exercised by automated CI and needs manual verification on a real desktop

dsh-desktop-pet DSH plugin: from the repository README

Quoted from the sereinmono/dsh-desktop-pet README, the upstream source of the dsh-desktop-pet DSH plugin. Copyright remains with the original authors.

English | [中文](README.zh.md) An **optional desktop companion** for [deepseek-harness](https://github.com/deepseek-ai/deepseek-harness). It shows a small animated pet as an ambient status indicator: the pet relaxes when the harness is idle, "thinks" while the model reasons, "works" while tools run, waits when the harness needs input, and celebrates (or frowns) when a turn finishes. It is **not** a second chat UI, a task manager, or a full desktop app. It is a status indicator. - **Plugin-first**: a normal deepseek-harness plugin — no separately launched daemon, browser, or desktop app. - **Zero network**: all assets ship with the plugin; no telemetry, CDN, or remote service. - **Zero added LLM cost**: event → state resolution is fully deterministic. - **Runtime-discovered pets**: pets under `assets/pets/` are discovered at startup, so adding a pet is dropping a folder in — no rebuild. --- ## Installation The plugin is a Cordis **bundle** that ships both a host half (the pet window) and a client half (the settings card). `dsh plugin add` installs it and, because the manifest declares `dsh.bundle`, adds it to the profile's bundle list automatically. ### From npm ```sh dsh plug

Read the full READMEThe repository declares no license. Check with the authors before using it.

dsh-desktop-pet DSH plugin questions

How do I install dsh-desktop-pet?

Run `dsh plugin --profile <name> add dsh-desktop-pet` from the npm registry, or use a local path, tarball, or git repository. After installation, start Harness with `dsh --profile <name>` and the pet should appear on your desktop.

Does the pet require internet access?

No. All assets are bundled with the plugin, and there is no telemetry, CDN, or remote service. The pet is fully offline.

Can I add my own custom pet?

Yes. Place a folder containing `pet.json` and `spritesheet.webp` under `assets/pets/` in the plugin directory. The plugin discovers pets at startup. You can also use the `hatch-pet` skill or download community pets from Petdex.

Why doesn't the pet show on macOS?

macOS is not supported. The plugin only implements native overlay windows for Windows 11 and Linux (X11 with a compositor). A backend interface is reserved for future macOS support but is not yet implemented.

How do I enable developer mode to test pet states?

If the `ctx.commands` service is present (usually from the core harness), you can use the `/pet` command in the chat area. For example, `/pet thinking` or `/pet working`. This simulates states without requiring an LLM.