Repolode
Submit
Sutera-Diffusus

Sutera-Diffusus/dsh-whale-musume

A desktop pet mascot plugin for the DeepSeek Harness that switches poses based on the tools you are running and stays quiet while you work.

View on GitHubWebsite
Stars
208
Forks
19
Open issues
5
Last commit
11 hours ago

What is it?

Whale Musume is a desktop mascot plugin for DeepSeek Harness (DSH). It floats in the corner of the DSH window and reads structured markers from the host, such as tool-card state and running-session flags, to decide which pose to show. While a tool is running it holds a laptop and avoids speech bubbles or pose changes; idle chat, reminders and greetings only happen when the user is not working.

The plugin also includes a progress layer: daily tasks, a weekly check-in board, 45 achievements, a growth diary, and three mini-games (a bubble-popping game, a catch-the-snack game and a memory card match). Save data lives in the host's localStorage, and the project states it has no telemetry and makes no external requests by default. Weather, balance display and keyword detection are off unless the user enables them.

It installs through the DSH plugin command from npm or GitHub, or by a Release zip. The README lists support for the DSH desktop app on Windows 10/11 and the legacy web profile, with a compatibility matrix by DSH version.

Key features

  • 01Pose switching based on which tool types are running, such as commands, file edits, search and tests.
  • 02Stays silent and keeps its pose steady during active work, with chat and reminders only while idle.
  • 03Five display modes (floating, sidebar, bottom bar, mini, auto) and drag-to-move with saved position.
  • 04Daily tasks, weekly check-in, affection levels and 45 achievements with a growth diary.
  • 05Three mini-games: bubble popping, catching snacks, and a 4x4 memory match.
  • 06Cross-device save export and import as JSON or a checksummed migration code.
  • 07Local-first design with no telemetry; weather, balance and keyword features are off by default.

Use cases

  • Keeping a lighthearted companion on screen while using DeepSeek Harness for coding sessions.
  • Moving progress between the DSH desktop app and the legacy web profile through the built-in migration tool.
  • Customizing a desktop mascot whose behavior follows tool activity rather than random timers.

Quick start

  1. 1

    Install from npm into the Web profile

    dsh plugin --profile web add dsh-whale-musume
  2. 2

    Restart the host (restart dsh web, then press Ctrl+F5) and she appears in the lower right corner

Things to know

  • Desktop support is limited to Windows 10 and 11.
  • Compatibility with some DeepSeek Harness versions is only a static check, not tested in a real Electron run.
  • Save data stays in each host's localStorage and does not carry over automatically between desktop and web.

In collections

Privacy & local-first tools

Topics

#ai-assistant#desktop-pet#mascot#deepseek#local-first#electron#plugin#ai-companion#cordis#cute

FAQ

What is dsh-whale-musume?
A desktop pet mascot plugin for the DeepSeek Harness that switches poses based on the tools you are running and stays quiet while you work. Whale Musume is a desktop mascot plugin for DeepSeek Harness (DSH). It floats in the corner of the DSH window and reads structured markers from the host, such as tool-card state and running-session flags, to decide which pose to show. While a tool is running it holds a laptop and avoids speech bubbles or pose changes; idle chat, reminders and greetings only happen when the user is not working.
Is dsh-whale-musume free to use? What license does it have?
dsh-whale-musume is open source under the MIT license. Check the license terms before using it in commercial products.
Is dsh-whale-musume still maintained?
Actively maintained. The last commit to dsh-whale-musume was on Nov 7, 2026.
What can I use dsh-whale-musume for?
Keeping a lighthearted companion on screen while using DeepSeek Harness for coding sessions. Moving progress between the DSH desktop app and the legacy web profile through the built-in migration tool. Customizing a desktop mascot whose behavior follows tool activity rather than random timers.
How do I install dsh-whale-musume?
Install from npm into the Web profile: dsh plugin --profile web add dsh-whale-musume Restart the host (restart dsh web, then press Ctrl+F5) and she appears in the lower right corner
Where can I get dsh-whale-musume?
The source code and installation instructions are on GitHub: https://github.com/Sutera-Diffusus/dsh-whale-musume

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects