This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.

Quick start

harness-pet

— source: plugin_wiki.wiki_content

Install & verify

dsh plugin --profile web add --allow-build=harness-pet github:cakeni/harness-pet

Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.

— source: plugins.install

Key points

• Nine visual states: idle, thinking, working, searching, bash, editing, waiting, error, and success.
• Dragging uses dedicated left/right swimming rows; clicking plays a short flipper wave without sprite overflow.
• Optional Chromium desktop-window mode keeps the pet visible in an always-on-top Document Picture-in-Picture window while the main Harness window is minimized.
• Draggable, viewport-clamped position saved in localStorage.
• Pet size, opacity, enable/disable, reset position, and reduced-motion controls.

— source: plugin_wiki.readme_en (fallback readme_raw)

FAQ

What if the whale doesn't appear in the bottom right corner after installation?

First confirm window.__DSH_BOOT__.entries contains harness-pet, then confirm /plugins/harness-pet/client.js returns HTTP 200; the plugin is registered to the web profile via dsh.bundle.patch, and after first installation or removal, you must restart the dsh web process for the host to re-scan the plugin list.

Is this an official DeepSeek project?

No. This is an unofficial community project with no affiliation, endorsement, or maintenance relationship with DeepSeek. The disclaimer is prominently stated in the README, at the bottom of the UI, and in the page text.

Will the plugin upload my conversation content?

No. The plugin does not make any independent network requests (no fetch, no analysis, no telemetry). Conversation text is only rendered locally and is not persisted; only when you actively click send in the follow-up input box on the whale will the text be submitted to Harness's own channel via the official SessionFace.

What if I can't find a state that matches the current tool?

The adapter tool name list only recognizes official naming (web_search / bash / str-replace-editor, etc.). Unrecognized running tools are downgraded to working rather than being faked as searching/bash/editing, so it won't misreport when the 1.0 pre-API changes.

What if clicking "Open Floating Pet" does nothing?

This feature depends on Chromium 116+ Document Picture-in-Picture API; non-Chromium browsers (like Firefox/Safari) will have the button directly disabled and unusable, and the browser process and corresponding tab must remain open for the whale to stay in the floating window.

Where are settings saved? Will they be lost after deleting account/login?

Only saved in browser localStorage (harness-pet:settings), containing language, enabled, size, transparency, position, Reduce Motion, Debug State, auto-rotate. Clearing browser data or logging in from a different browser will lose the settings and require reconfiguration.

How to uninstall?

Execute dsh plugin --profile web remove harness-pet then restart dsh web; if installed via local link, delete the corresponding line from the link:../harness-pet directory and restart the host.

Will reduced motion switch completely stop animations?

No. Both the system's prefers-reduced-motion: reduce and the setting panel's Reduced Motion only stop continuous floating and frame animations, but will still display the correct current state static frame, so the pet can still feedback what Harness is doing.

— source: plugin_wiki.faq_json

Compatibility

• DSH: >=0.1.0-rc.6
• Node: >=22

— source: plugin_wiki.compatibility_json

Pitfalls

Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.

— source: general rule