deepseek-pet: An Interactive Desktop Pet Plugin for DeepSeek Harness That Adds a Blue Whale with Changing Expressions
keleus/deepseek-pet
Raise a Live2D-style desktop pet in DeepSeek Harness that switches expressions based on tasks, tool calls, and session states, with drag, zoom, and interaction support.
deepseek-pet is a DSH plugin for DeepSeek Harness that adds an interactive desktop pet to the web interface, letting you keep a big blue whale that reacts to your workflow. It automatically switches expressions based on current tasks, tool calls, context usage, and active sessions, with Live2D-style effects like breathing, bouncing, tilting, parallax, and fade-in animations. Beyond state-aware expressions, it offers a status bubble ticker, multi-session management, interactive controls, and customizable settings, making the workspace less monotonous. Once installed, a blue whale appears in the bottom-right corner to keep you company, ideal for developers who want to make DeepSeek Harness more fun.
How to Install
dsh plugin --profile web add deepseek-pet- Category
- Entertainment
- Platform
- DSH Plugin
- Author
- keleus
- Distribution
- Plugin
deepseek-pet Key Features
deepseek-pet Repo Summary
What Does It Do?
DeepSeek Pet is a DSH plugin for DeepSeek Harness that adds an interactive desktop pet to the web interface, letting you keep a big blue whale that reacts to your workflow. It solves the problem of a dull, monotonous workspace by automatically switching the pet's expressions based on current tasks, tool calls, context usage, and active sessions, with Live2D-style effects like breathing, bouncing, tilting, parallax, and fade-in animations. Core capabilities include state-aware expressions, status bubble ticker, multi-session management, interactive controls, and customizable settings.
Core Features
- State-aware expressions: automatically switches expressions for scenarios like analysis, answering, coding, web search, sub-agents, completion, and failure, cycling through working poses during answer phases.
- Status bubble ticker: shows rotating status phrases in a bubble above the pet with a typewriter effect, auto-hiding after 10 seconds of inactivity.
- Multi-session management: displays the focused session in a bar below with a highlighted border, stacks active sessions downward, collapses when more than three, and enters a "super busy" state during parallel execution.
- Interactive controls: supports dragging the pet, single-click interaction, double-click collapse, scroll-wheel scaling (65%–140%), and remembers position and size.
- Smart reminders: shows "can eat a bit more" at 62% context, "full" at 82%; shows hungry after 10 minutes idle, sleepy with a pillow after 30 minutes, and sleeping after 1 hour.
- Custom settings: adds a "Pet Settings" page in the settings panel, letting you enable/disable specific images per action group, with two display modes: default and pinned to top.
How to Use This Plugin?
After enabling it in DSH, the pet appears in the bottom-right corner (in pinned mode) or at the default position. Drag the pet to move it, hover and scroll to resize, single-click for a short feedback phrase, double-click or click the "−" button to minimize to a static icon. Click an active session to make it the focused session, and when approval or question cards appear, you can select, input, allow, or reject directly. Use the settings page to configure action images and display mode; refresh the page after changes.
This page is an independent rewrite of the plugin's official README — for authoritative documentation and the latest changes, refer to the source: keleus/deepseek-pet. The plugin is third-party code that runs on your machine once installed; inclusion does not imply endorsement — please review the source before installing.