dsh-mint-budgie

Mint Budgie is a desktop-only pet for DeepSeek Harness (dsh). It floats above other windows, shows the current project and activity only while the agent is working, and does not render a second pet inside the dsh window.

English | 简体中文

Features

• Drag the pet across every monitor on the Windows virtual desktop.
• Release a drag to let the pet fall naturally. A quick flick throws it with bounded velocity, gravity, wall bounce, floor friction and a short bottom-anchored landing squash.
• The task bubble temporarily hides while the pet is airborne, then returns after the pet settles.
• While idle, the pet plays a random gesture every 30–75 seconds using a randomized delay and avoids repeating the same gesture consecutively.
• Single-click plays one random gesture: head tilt, head stretch, spread wings or side-wing wave. Every gesture starts and ends in the standing pose.
• Gesture frames normalize the apparent head scale while allowing each pose to keep its own position and perspective.
• Both the pet and task bubble detect per-monitor work areas, shift away from screen edges and never straddle a dual-monitor boundary.
• Double-click opens or hides the dsh window. If an active task bubble is minimized, the same double-click restores it.
• Right-click for settings or to hide the pet.
• Size and opacity support sliders, numeric input and reset; both persist.
• The Codex-style task bubble stays fixed at 284x65 and scrolls long activity text horizontally. Idle shows no bubble and no "idle" label.
• Every sprite frame is aligned to one shared foot line, so the pet rests directly on the work-area floor without clipping low frames.
• Wing gestures use the complete supplied source drawing. The generator never cuts out or rotates individual wings, so faces and torsos stay intact.

Development plan

The physical drag/throw roadmap, status interactions and size-reduction plan are documented in docs/DEVELOPMENT-PLAN.zh.md (Chinese).

Status mapping

Source signal	Pet row	Label
any agent is running or the session has an open turn	running	Running
approval/request open	waiting	Waiting
agent/error within 4 s	failed	Failed
otherwise	idle	no bubble

Agent.status itself is only idle | running; the waiting and failed rows come from the two transient Host events above.

Architecture

The dsh Host writes desktop/state.json; desktop/pet-window.pyw polls it and renders the desktop window with tkinter + Pillow. The Host may start the pet, but the pet process survives a Host restart. desktop/setup-startup.ps1 can also install a login shortcut that launches the pet independently.

The process uses a per-monitor DPI-aware context so mixed-scale monitors keep consistent sprite and window coordinates. The pet seeds the user's AppData settings from desktop/default-settings.json; the right-click settings panel writes to the per-user copy so plugin upgrades do not overwrite preferences.

The launcher prefers the newest packaged desktop/mint-budgie-<version>.exe, so Windows users do not need Python and upgrades can coexist with a currently running pet. If no executable is available, Pillow and tkinter are required and Python is resolved from DSH_PET_PYTHON, then pyw.exe, pythonw.exe, py.exe, and python.exe on PATH.

Install

From the DSH plugin market, search for dsh-mint-budgie and install it, then restart dsh. Or install the public npm package:

dsh plugin --profile desktop add dsh-mint-budgie

Python dependencies:

py -m pip install Pillow

Windows is currently the only supported platform.

Files

• index.js - Host state polling, persistence and desktop-process bridge
• client.js - compatibility shim; intentionally registers no in-window pet
• desktop/pet-window.pyw - standalone desktop overlay
• desktop/pet_physics.py - dependency-free drag, throw, collision and landing physics
• assets/spritesheet.png - working/status sheet read by the desktop overlay
• assets/poses/head-tilt_<frame>.png - aligned click gesture frames

Disabling

Remove dsh-mint-budgie from dsh.profile.bundles in the active profile's package.json, then restart dsh.