dsh-plugin-linux
DiscoveredDeepSeek Harness Linux desktop wrapper + native system plugin (systemd, journalctl, clipboard, containers)
DeepSeek Harness — Linux Desktop + System Plugin
Native Linux desktop wrapper for DeepSeek Harness plus a Cordis plugin that adds native system capabilities (systemd, journalctl, clipboard, containers, notifications).
What you get
1. Desktop wrapper (apps/desktop-linux/)
Tauri 2 + Rust + WebKitGTK. Manages dsh web and opens a native window pointed at its tokenized URL.
- Spawns
dsh web --port 0 --no-open, reads tokenized URL from stdout - System tray: Show Window / Quit
- Close-to-tray: X button hides, backend keeps running
- Global shortcut
Ctrl+Shift+D(X11/XWayland) + SIGUSR1 fallback for Wayland - D-Bus notifications + Unix socket bridge for plugins (
$DSH_NOTIFY_SOCK) - Clean shutdown: SIGTERM → SIGKILL to the whole backend process group
2. System plugin (packages/extensions/plugin-linux-system/)
Cordis plugin registering 7 tools with the agent:
linux_systemd_status(unit, scope?)— structured unit statuslinux_systemd_action(unit, action, scope?)— start/stop/restart/enable/disablelinux_journal(unit?, lines?, since?)— structured journalctl entrieslinux_clipboard_get()— read clipboard (Wayland-first, X11 fallback)linux_clipboard_set(text)— write clipboardlinux_containers()— list running containers (podman/docker)linux_notify(summary, body?, urgency?)— native notification
Prerequisites
- Node.js >= 22 —
sudo dnf install -y nodejs(Fedora) orsudo apt install -y nodejs(Debian/Ubuntu) - DeepSeek Harness backend —
npm install -g @deepseek-ai/dsh. Verify withcommand -v dsh - DeepSeek account with API quota — the agent needs it to respond; plugin loads without it
Installation
AppImage (any Linux distro):
chmod +x DeepSeek-Harness_0.1.0_amd64.AppImage
./DeepSeek-Harness_0.1.0_amd64.AppImage
Fedora / RHEL / CentOS:
sudo dnf install -y DeepSeek-Harness-0.1.0-1.x86_64.rpm
Debian / Ubuntu:
sudo dpkg -i DeepSeek-Harness_0.1.0_amd64.deb
sudo apt-get install -f
First launch: dsh-desktop-linux — wait 20-40s for backend, then window opens.
Desktop integration
- Tray — Left-click shows window; Right-click opens Show/Quit menu
- Close X — Hides to tray, backend keeps running
- Quit — Tray → Quit → clean shutdown of all processes
- Ctrl+Shift+D — Toggle window (X11/XWayland)
- Notifications — D-Bus toasts + Unix socket bridge for plugins
Wayland shortcut setup
On GNOME/Wayland, Ctrl+Shift+D may silently no-op. Bind a GNOME custom shortcut instead:
mkdir -p ~/.local/bin
printf '#!/bin/sh\npid=$(pgrep -u "$USER" -f dsh-desktop-linux | head -1)\n[ -z "$pid" ] && exit 1\nkill -USR1 "$pid"\n' > ~/.local/bin/dsh-harness-toggle
chmod +x ~/.local/bin/dsh-harness-toggle
Then in GNOME Settings → Keyboard → Custom Shortcuts, bind Ctrl+Shift+D to ~/.local/bin/dsh-harness-toggle.
Plugin installation (opt-in)
git clone https://github.com/agabadouglas308/dsh-plugin-linux.git
cd dsh-plugin-linux
./scripts/install-plugin.sh
No pnpm install needed — the plugin ships pre-built (lib/index.mjs).
Restart dsh-desktop-linux. Verify in Settings → Built-in plugins → search linux-system. Status should show Running.
Test: in the chat panel, ask the agent "What is the status of sshd.service? Use the linux_systemd_status tool."
Troubleshooting
- Backend failed to start: no dsh backend found — run
npm install -g @deepseek-ai/dsh, ensurecommand -v dshresolves - Window blank for >60s — check terminal for
dsh.stderrlines - ACCOUNT_QUOTA in chat — DeepSeek API quota exhausted, unrelated to wrapper
- Ctrl+Shift+D does nothing (Wayland) — use the SIGUSR1 fallback above
- Plugin not in Settings — rerun
./scripts/install-plugin.sh, restart app
Development
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness/apps/desktop-linux
cargo build # dev build
cargo tauri build --bundles deb,rpm,appimage
Environment variables:
DSH_REPO— path to a deepseek-harness checkout (dev mode; overridesdshon PATH)DSH_PROFILE— which profile to install the plugin into (default:web)DSH_HOME— DSH home root (default:~/.dsh)RUST_LOG=dsh_desktop_linux=debug— verbose wrapper logging
License
MIT — see LICENSE.
Comments
Loading…
Similar plugins
by ShiTan-677
DeepSeek Harness plugin: install, repair or remove the Linux desktop entrance for the Web GUI from inside the harness.
★ 0
MIT
JavaScript
Oct 14, 2026
dsh plugin --profile web add dsh-linux-desktop-entryby MarecGents
DeepSeek Harness 生态的 Windows 桌面插件项目。 A Windows desktop plugin project for the DeepSeek Harness ecosystem.
★ 3
MIT
JavaScript
Sep 25, 2026
dsh plugin --profile web add @marecgents/dsh-hubby anywhere-labs
为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」,桌面本身也是「插件」。
★ 36.3k
↓ 136/wk
MIT
TypeScript
Nov 18, 2026
dsh plugin --profile web add dsh-plugin-desktopby leolee9086
Independent cross-platform desktop computer-use plugins for DeepSeek Harness (region capture via a bundled native helper)
★ 0
MIT
JavaScript
Oct 4, 2026
dsh plugin --profile web add dsh-computer-useby ffyfox
DeepSeek Harness 的 Linux 原生桌面集成:XDG 桌面入口、纯净无边框独立窗口、关窗自动停服务。Native Linux desktop integration for DSH.
★ 0
MIT
JavaScript
Sep 19, 2026
dsh plugin --profile web add dsh-plugin-linux-desktopby wee-b
DeepSeek Harness disk analysis and safe cleanup plugin for Windows.
★ 19
MIT
JavaScript
Oct 1, 2026
dsh plugin --profile web add @dsh-plugin/disk-sentinel