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.
- Shimmernight 🌹🌹🌹🌹 (#78)
- vk-liu-cn-1 🌹 (#97)
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:
Links
More in this category
zhu1090093659/dsh-web#packages/dsh-task-board★ 8978
Task board for the dsh web GUI: a sidebar multi-column kanban whose cards run in real DSH agent sessions and can also be scheduled with cron expressions, executed host-side even with the browser closed.
zhu1090093659/dsh-web#packages/dsh-web-all★ 8978
Plugin and skin collection for the DSH Web UI: task board, Git graph, right-side panel, remote mobile UI, pet, live token stats, and a skin center.
MeteorNOX/DeepSeek-Balance-Whale-Widget★ 5292
A fixed-corner whale widget for the DSH web GUI — balance, today's usage and per-turn cost with peak/off-peak pricing, editable balance-alert and daily-budget bubbles, a module-based custom bubble queue with A/B weighted choices and random lines or images, 30+ vendor templates (OpenAI, OpenRouter, Kimi, SiliconFlow, Ark, Zhipu, MiniMax and more) with per-model balance and subscription quota, plus task-end sound, imported audio, custom roles and a resource manager. Local-only, no telemetry.
ccch1mneyyy/dsh-TUI★ 4819
Claude Code-style full-screen terminal UI: pixel-whale header, live status line, and streaming thought expansion.
omdsh-dev/DSH-better-sidebar★ 4290
Full sidebar workbench with file rendering and editing, terminal, Git, and subagents; third-party plugins can register new tabs.
Devin-AXIS/deepseek-design#deepseek-idesign★ 1478
Visual design studio for websites, app prototypes, posters, cards, reports, and magazines, with templates, direct element editing, selection-aware AI draft handoff, and export.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.