Repolode
Submit
QCYTSN

QCYTSN/dsh-dafeiyu

A transparent, always-on-top desktop companion for DeepSeek Harness that shows live agent task status and balance on Windows, Linux and macOS.

View on GitHub
Stars
600
Forks
51
Open issues
12
Last commit
9 days ago

What is it?

DSH Dafeiyu is a desktop pet-style companion that launches with the DeepSeek Harness (DSH) plugin system and exits with it. It runs as a transparent, borderless, always-on-top native window, so you can see what the agent is doing while working in an editor, browser or other app.

The companion reflects real task states from DSH session events, including thinking, searching, editing, running, verifying, waiting for confirmation, completion and errors. It can show project steps, multi-task progress and todo lists when DSH provides them, and displays DeepSeek balance for either an API key or a logged-in account. It does not read the screen.

It supports both the browser WebUI and the official DSH desktop app, each with its own plugin profile. Installation is through the DSH plugin command or the desktop app's plugin page, and a single package covers Windows, Linux and macOS.

Key features

  • 01Shows live agent task states such as thinking, editing, running and waiting for confirmation.
  • 02Displays project steps, multi-task progress and todo items when DSH supplies them.
  • 03Shows DeepSeek balance for API keys or logged-in accounts, with manual refresh.
  • 04Supports dragging, click interactions and adjustable size, bubble, sound and reduced-motion settings.
  • 05Works with both the DSH WebUI and the official desktop app, each with its own profile.
  • 06Can optionally show a lightweight character inside the DSH web page.

Use cases

  • Keeping an eye on a long-running coding agent while working in another application.
  • Checking DeepSeek API or account balance without opening the settings page.
  • Getting a sound or bubble notification when an agent task finishes or errors.

Quick start

  1. 1

    Install the plugin into the WebUI profile

    npx -y @deepseek-ai/dsh plugin --profile web add dsh-dafeiyu@0.1.21
  2. 2

    Start the DSH WebUI

    npx -y @deepseek-ai/dsh web
  3. 3

    For the official desktop app, install the plugin from its in-app Plugins page

Things to know

  • It requires a running DeepSeek Harness host, so it is not a standalone app.
  • The native character appears only on the desktop where the host runs.
  • macOS support is experimental.
  • Linux arm64 has no bundled helper and needs python3 and PySide6 installed.

In collections

Open-source AI agent frameworks & appsOpen-source Mac apps

Topics

#ai-agent#deepseek#desktop-pet#developer-tools#windows#linux#macos#plugin#agent-companion#deepseek-harness

FAQ

What is dsh-dafeiyu?
A transparent, always-on-top desktop companion for DeepSeek Harness that shows live agent task status and balance on Windows, Linux and macOS. DSH Dafeiyu is a desktop pet-style companion that launches with the DeepSeek Harness (DSH) plugin system and exits with it. It runs as a transparent, borderless, always-on-top native window, so you can see what the agent is doing while working in an editor, browser or other app.
Is dsh-dafeiyu free to use? What license does it have?
dsh-dafeiyu is open source under the MIT license. Check the license terms before using it in commercial products.
Is dsh-dafeiyu still maintained?
Actively maintained. The last commit to dsh-dafeiyu was on Oct 29, 2026.
What can I use dsh-dafeiyu for?
Keeping an eye on a long-running coding agent while working in another application. Checking DeepSeek API or account balance without opening the settings page. Getting a sound or bubble notification when an agent task finishes or errors.
How do I install dsh-dafeiyu?
Install the plugin into the WebUI profile: npx -y @deepseek-ai/dsh plugin --profile web add dsh-dafeiyu@0.1.21 Start the DSH WebUI: npx -y @deepseek-ai/dsh web For the official desktop app, install the plugin from its in-app Plugins page
Where can I get dsh-dafeiyu?
The source code and installation instructions are on GitHub: https://github.com/QCYTSN/dsh-dafeiyu

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

Related projects