deepseekplugins

DeepSeek Harness plugin

dsh-pixel-whale

A lively pixel-whale loading companion for DeepSeek Harness Web.

Just for Fun
Jump to install

Source facts

Repository
yoke233/dsh-pixel-whale
Latest update
Aug 13, 2026
Category
Just for Fun
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/yoke233/dsh-pixel-whale
Plugin: dsh-pixel-whale
Author: yoke233

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

<p align="center"> <img src="./assets/readme/hero.svg" width="100%" alt="dsh-pixel-whale — a living pixel companion for DeepSeek Harness Web"> </p>

<p align="center"> <a href="./LICENSE"><img alt="MIT License" src="https://img.shields.io/badge/license-MIT-172033?style=flat-square"></a> <img alt="DSH Web plugin" src="https://img.shields.io/badge/DSH-Web_plugin-4D6BFE?style=flat-square"> <img alt="Node.js 22.19 or newer" src="https://img.shields.io/badge/node-22.19%2B-3F5FD9?style=flat-square"> </p>

dsh-pixel-whale adds a compact, animated point-cloud whale immediately before the Deep diving... status in DeepSeek Harness Web. It appears with a running turn, follows the status across UI remounts, and leaves when the turn ends.

See it in DSH Web

<p align="center"> <img src="./assets/readme/demo.png" width="100%" alt="The pixel whale rendered by the production plugin beside the Deep diving status"> </p>

This screenshot is rendered from the production browser bundle. In motion, the whale's large head stays weighty while the body bends, the tail and fin rebound, and small bubble scenes rotate between loops. Its pixels use a restrained blue palette with stable colors—movement comes from the body, not flashing points.

Install

dsh plugin --profile web add github:yoke233/dsh-pixel-whale

Restart DSH Web after the first installation. The whale appears automatically while a turn is running; there are no commands or settings to configure.

The installer may report peer-dependency warnings for DSH and React packages. Those packages are supplied by the DSH Web host; a completed install ending with Done is expected.

How it works

1. The plugin mounts through DSH's session-scoped conversation.input.dock lifecycle. 2. useSession provides the authoritative running state. 3. A scoped MutationObserver follows the current conversation's status row. 4. A React portal places the whale before Deep diving... and cleans it up when the turn stops or the plugin unloads.

DSH does not currently expose a public Slot inside its private turn-status component, so the small DOM adapter is intentionally isolated to one selector and one current-conversation observer. It does not replace the status text or write session data.

Design details

  • Compact: renders at 36 × 26px and stays on the status line.
  • State-aware: visible only while the current session is running.
  • Calm motion: stable pixel colors, restrained breathing, larger body and tail movement.
  • Accessible: respects prefers-reduced-motion.
  • Web-only: no prompt, tool, model-request, or host behavior changes.

Development

pnpm install
pnpm check

pnpm check runs TypeScript validation, motion and DOM-lifecycle tests, then builds the host and browser entries. Release packages are built entirely from published npm dependencies and include only the generated lib output, bundle patch, README, and license.

Compatibility

  • DeepSeek Harness packages: ^0.1.0-rc.6
  • Node.js: ^22.19.0 || >=24
  • Surface: DSH Web

The status-row selector follows the current DSH Web markup. If DSH later exposes a dedicated turn-status Slot, the adapter can move to that Slot without changing the animation engine.

License

[MIT](./LICENSE)

Back to searchOpen GitHub repository

More related plugins

View category