DeepSeek Harness Plugin

FeatherHunter/dsh-im-companion

Stars ★ 29 Downloads (30d) 4,176 Category UI Enhancements Added 2026-09-04 npm dsh-im-companion

IM Companion for dsh-im: groups Feishu/WeChat/QQ bots by Agent in DSH workspaces and enhances DSH native session states (blue/orange/red rail markers for running, needs-review and error), with left badges, one-click filter, fleet overview and drag-to-move. Clean uninstall.

Install

# from npm (prebuilt)

dsh plugin --profile web add dsh-im-companion

# from a prebuilt release tarball

dsh plugin --profile web add "https://github.com/FeatherHunter/dsh-im-companion/releases/download/v0.2.12/dsh-im-companion-0.2.12.tgz"

# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)

dsh plugin --profile web add github:FeatherHunter/dsh-im-companion

Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).

README

Chinese · 中文

dsh-im-companion enhances dsh-im with the concepts of assistants and homes.

Your star means the world to me.

Give every agent a home — IM Companion handles the rest.

One minute to install (dsh-im first, then the companion).

Prerequisites: DSH (DeepSeek Harness) + dsh-im (the IM bot core).

# 1. Install the DSH CLI (skip if installed)
npm install -g @deepseek-ai/dsh

# 2. Install the dsh-im core first (skip if installed; --profile is required too)
dsh plugin --profile desktop add dsh-im
#     or
dsh plugin --profile web add dsh-im

# 3. Then install the companion (--profile is required: the entry you actually use)
dsh plugin --profile desktop add dsh-im-companion
#     or
dsh plugin --profile web add dsh-im-companion

# Pin a version for stability (current: 0.2.16)
dsh plugin --profile desktop add dsh-im-companion@0.2.16 --registry https://registry.npmjs.org

Refresh the page after installing and it takes effect. If the panel does not show up, quit DSH completely and reopen it.

Copy the text below and send it to your AI:

Please install the DeepSeek Harness plugin dsh-im-companion (the IM companion).
Read the repo README first: https://github.com/FeatherHunter/dsh-im-companion
First confirm which profile my DSH entry uses (desktop app goes to desktop, self-hosted web service goes to web),
then confirm the dsh-im core is in the same profile (install it first if missing), then install the companion into the right profile.

Below uses desktop as the example; web users replace --profile desktop with --profile web:

dsh plugin --profile desktop add dsh-im-companion@0.2.16 --registry https://registry.npmjs.org
npx --yes @deepseek-ai/dsh plugin --profile desktop add dsh-im-companion
dsh plugin --profile desktop add dsh-im-companion@latest --registry https://registry.npmjs.org

Upgrade · Uninstall:

dsh plugin --profile desktop update dsh-im-companion
dsh plugin --profile desktop remove dsh-im-companion

dsh-im owns connecting; dsh-im-companion adds capabilities through the concepts of assistants and homes.

Home: which workspace has an assistant minding it, online or not, all in view; moving takes one drag.

👇 Click “with-assistant” to see only settled homes.

👇 Settings → IM companion: assistants, channels and online states on one screen.

👇 Switch to channels: same-channel assistants line up.

👇 Click “add connection”: pick a home, scan, bound.

👇 Open an assistant card: mode, status and per-channel switches at a glance.

👇 Fleet radar: the Agent × channel matrix shows the whole fleet online state.

👇 Session states at a glance (DSH enhanced).

👇 Click the robot-face icon in the toolbar to open the moving panel

👇 Move house: drag the photo to another home, confirm twice. Green on duty, yellow napping, grey asleep.

👇 Drag the card over another home and the target lights up

👇 Confirm before moving

That is the desktop app-market cache: freshly published versions are silently skipped for a few hours. Wait a few hours and update again; if you cannot wait, install once with the explicit official registry:

dsh plugin --profile desktop add dsh-im-companion@latest --registry https://registry.npmjs.org

dsh-opencode-palette —— 34 classic opencode themes, one-click switch

dsh-mattpocock-skills-deck —— Matt Pocock skills deck: 25 engineering and productivity skills, ready to use

dsh-chinese-skill-patch —— Chinese skill names that just work, no English rename needed

dsh-prompt —— Prompt toolbox: 24 deep templates at hand


Any question, suggestion, idea, feedback, or rant - file an ISSUE! 🌹

MIT © FeatherHunter

Thanks to everyone who files Issues and PRs and joins discussions.

Also thanks to upstream dsh-im: no core, no companion plugin.

Bugs and ideas go straight to ISSUEs — faster and traceable.

File an ISSUE · Upstream dsh-im

👇 DSH plugin chat group (Feishu), scan to join:

Content from the project README on GitHub ↗

Links

More in this category

View the whole category →

Community comments

Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.