Howling202524/dsh-whale-girl-tauri
Whale Girl Tauri is a standalone Windows x64 desktop-pet bundle for DeepSeek Harness. The official Harness loads a Cordis plugin that observes agent work, approval waits, and turn results and projects them into visual states; a prebuilt Tauri 2 sidecar renders an animated "whale girl" in a transparent, always-on-top WebView2 window. The pet stays neutral while the pointer overlaps its window, follows the pointer only within roughly one body length outside it, and returns to neutral at greater distances; releasing a drag restores the animation for the current Harness state, and double-clicking the pet or choosing "Open Harness" opens the Harness URL in the system browser. Its context menu can resize it from 50% to 120% or restore the default (selected size persists).
Install
Invoke-WebRequest https://github.com/Howling202524/dsh-whale-girl-tauri/releases/download/v0.1.2/dsh-whale-girl-tauri-0.1.2.tgz -OutFile dsh-whale-girl-tauri-0.1.2.tgz; dsh plugin --profile web add .\dsh-whale-girl-tauri-0.1.2.tgz; dsh --profile webRequirements: Windows x64, Node.js ^22.19.0 || >=24, the official dsh CLI, and Microsoft Edge WebView2 Runtime (included by default on Windows 11). Download the prebuilt v0.1.2 release tarball, add it to the web profile, then start DSH. A local-build form is also documented (dsh plugin --profile web add D:\path\to\dsh-whale-girl-tauri). The release contains only the Windows x64 sidecar (archive ~6.4 MB, unpacks to ~8.4 MB); WebView2 is shared by the OS. Building from source additionally needs stable Rust and the Visual Studio 2022 Build Tools "Desktop development with C++" workload with a Windows SDK. Uninstall with dsh plugin --profile web remove dsh-whale-girl-tauri.
Compatibility
Windows x64 only. Node.js ^22.19.0 || >=24; the official dsh CLI; Microsoft Edge WebView2 Runtime (bundled with Windows 11). The plugin loads a Cordis plugin that observes agent/status and session/event and launches a prebuilt Tauri 2 sidecar that creates a transparent always-on-top window via WebView2 -- so it does not ship Chromium or modify the official deepseek-harness repository. The sidecar exposes its process channel only on a random 127.0.0.1 port and generates a fresh Bearer token for every launch. Build-from-source additionally needs stable Rust and the MSVC C++ workload.
Details
- Repo: Howling202524/dsh-whale-girl-tauri
- Category: Entertainment & Lifestyle
- Stars: 1
- Version: GitHub release tarball v0.1.2 (no npm registry package claimed); MIT
- Last push: 2026-08-17
- First seen: 2026-08-14
Recent updates
The README documents the full config block for the plugin row whale-girl-tauri in $DSH_HOME/profiles/web/cordis.patch.yml (enabled, harnessUrl, showOnStart, alwaysOnTop, scale/minScale/maxScale/scaleStep, windowWidth/windowHeight, gazeRadiusBodies, gazeHysteresisDegrees, celebrationMs/failureMs/welcomeMs, pollIntervalMs, requestTimeoutMs, maxConsecutiveFailures, shutdownTimeoutMs) and warns that a profile patch replaces the complete config block. It describes the source layout (src/plugin.ts, src/activity.ts, src/sidecar/renderer.ts, src-tauri/, resources/whale-girl/) and the pnpm build/typecheck/lint/test/audit:pet workflow; pnpm build targets only x86_64-pc-windows-msvc.
FAQ
- How do I install the Whale Girl Tauri desktop pet?
- On Windows x64 with Node.js ^22.19.0 || >=24 and the dsh CLI, download the v0.1.2 release tarball and run dsh plugin --profile web add .\dsh-whale-girl-tauri-0.1.2.tgz, then dsh --profile web; Microsoft Edge WebView2 Runtime is required (bundled with Windows 11).
- Does it modify the official DeepSeek Harness repository?
- No -- the README states the official Harness loads a Cordis plugin that launches a prebuilt Tauri 2 sidecar; the plugin does not ship Chromium or modify the official deepseek-harness repository.
- Will the pet get in the way while I work?
- Per the README the pet is shown at 75% by default, stays neutral while the pointer overlaps its window, follows the pointer only within roughly one body length outside it, and can be resized 50%-120% from its context menu (the size persists).
Alternatives
2002yxy/dsh-desktop-pet · anneheartrecord/dsh-desk-pet · cakeni/harness-pet