dsh-bluewhale-pet

dsh-bluewhale-pet is an in-page companion plugin for DeepSeek Harness (DSH). A blue whale stays in the corner of the page while you work, so you can keep an eye on your tasks and respond to anything that needs your attention.

Features

• In-page companion: a blue whale lives in the corner of the DSH page while you work.
• Multiple tasks at a glance: see running, completed, failed, and pending tasks; when there are no notifications the pet just stays quiet.
• Act from the notification: open the associated conversation, stop its current turn, or handle approval, question, and plan requests.
• Full-screen roaming: while a task is running, the whale wanders freely around the page and swims back to its spot when the task ends (toggle and speed are configurable in settings).
• Built-in blue whale: a pixel-style blue whale ships with the plugin, ready to use out of the box. Custom pets in ~/.dsh/codex-pet/pets are shown as well.
• Small interactions: drag to move, double-click to jump, and right-click for the pet menu.

Usage

Open Settings → Pets, or open settings from the pet's right-click menu.

Create a custom pet

1. Open pet settings, click Create, and describe the companion.
2. Click Create in DSH. The plugin opens a dedicated task and sends the bundled Skill instructions.
3. Follow that task's progress. Creation uses DSH's configured model and image tools.
4. Once the pet files are saved, refresh the pet library and select the new companion.

Creating pets requires an image-generation tool configured in DSH.

Installation

This plugin is a personal fork and is not published to npm. It is installed into a DSH profile as a link: local dependency.

1. Clone this repository:

   git clone https://github.com/15372010668-dot/dsh-bluewhale-pet.git
   cd dsh-bluewhale-pet
   

2. Add it as a link: dependency in your DSH profile's package.json (example uses the web profile):

   {
     "dependencies": {
       "dsh-bluewhale-pet": "link:/absolute/path/dsh-bluewhale-pet"
     },
     "dsh": {
       "profile": {
         "bundles": ["...", "dsh-bluewhale-pet"]
       }
     }
   }
   

3. Restart DSH, then open Settings → Pets.

License

Licensed under the Apache License 2.0. See NOTICE for more information.