dsh-pet-desktop-linux: A Linux Desktop Pet for DeepSeek Harness
wlaeg/dsh-pet-desktop-linux
A Linux desktop pet plugin for DeepSeek Harness that shows your session state in a transparent always-on-top window — idle, working, waiting, failed or done.
dsh-pet-desktop-linux is a DSH plugin that lives on your Linux desktop and turns DeepSeek Harness session states into a small animated transparent pet. Instead of switching back to the page to check on a background task, you get a window that exists outside the browser and keeps animating even when the page is minimized or closed, with distinct animations for idle, working, waiting for an answer, failed, and finished-awaiting-review. The window stays on top and remains clickable, a right-click opens its menu and work-status dialog, and appearance and behavior are managed in the Desktop Pet panel of DSH Settings, which also probes system dependencies and shows a distribution-specific hint.
How to Install
dsh plugin --profile web add github:wlaeg/dsh-pet-desktop-linux- Category
- Entertainment
- Platform
- DSH Plugin
- Author
- wlaeg
- Distribution
- Plugin
dsh-pet-desktop-linux Key Features
dsh-pet-desktop-linux Repo Summary
What Does It Do?
Wlaeg/dsh-pet-desktop-linux is a DSH plugin for DeepSeek Harness that puts a small transparent, always-on-top desktop pet on your Linux desktop. It solves the problem of not being able to see what your DSH sessions are doing while the page is in the background: the pet window lives outside the browser, so it keeps animating even when the page is minimized or closed. It is maintained by Wlaeg under the MIT license, written in Python, and targets Linux with X11 or XWayland only.
Core Features
- Status animation: the pet switches sprite-sheet animations for idle, working, waiting for an answer, failed, and finished-awaiting-review states, so progress is visible at a glance.
- Separate always-on-top window: a borderless, fully transparent GTK3 window that stays above normal windows and is sticky across workspaces via xdotool.
- Clickable, not click-through: the window keeps its input region, so clicks land on the pet, and a right-click menu opens a work-status dialog.
- Settings panel: a Desktop Pet panel inside DSH Settings, with packaged English and Chinese locale strings.
- Dependency probing: the panel checks five system dependencies — Python 3, PyGObject, GTK3, GdkPixbuf, and xdotool — and shows a distribution-specific install hint when one is missing.
How to Use This Plugin?
After enabling it in DSH, the pet window floats on your desktop automatically and you can read the current session state from its animation without any extra steps. Right-click the pet to open its menu or the work-status dialog, and adjust appearance and behavior in the Desktop Pet panel of DSH Settings. If the pet starts but looks wrong, fill in the missing system dependencies the panel reports and make sure you are on an X11 or XWayland session — a pure Wayland session with XWayland disabled will not work. Replacing an already-installed copy requires restarting the DSH host process; a page reload is not enough.
This page is an independent rewrite of the plugin's official README — for authoritative documentation and the latest changes, refer to the source: wlaeg/dsh-pet-desktop-linux. The plugin is third-party code that runs on your machine once installed; inclusion does not imply endorsement — please review the source before installing.
DSH Plugin FAQ
