dsh-notifier DSH plugin

dsh-notifier provides a single notify() API that pushes session events and model-generated notifications to 25+ channels. It also enables remote approval and conversation from your phone, plus a web admin console and mobile command center with heartbeat, stall alerts, and stop buttons.

remote-execution ui-productivity

How to install the dsh-notifier DSH plugin

dsh plugin add dsh-notifier

Copying does not run this command. Review the repository and version before installing the dsh-notifier DSH plugin.

dsh-notifier DSH plugin data source

dsh-notifier DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-notifier DSH plugin can do

Dual trigger lines: auto-push session events (turn/end, approval/asked, agent/error) and a model-facing notify tool.
25+ channels: Telegram, Slack, Discord, Feishu, DingTalk, WeCom, QQ, Teams, Bark, Pushover, ntfy, webhook, and more, with zero runtime dependencies.
Level routing: timeSensitive / active / passive delivery semantics with tiered retries.
Remote approval and conversation: answer approvals via Telegram buttons, Feishu cards, or reply 1/2; chat with your agent and steer mid-turn.
Mobile command center (v0.5): long-task heartbeats, stall alerts, and a stop button on notifications.
Web admin console: local-only dashboard, notification stream, channel bindings, session management, and credential forms.
Multi-agent routing: bidirectional agent × channel matrix with auto-registration and CLI.
Anti-disturb rules, daily digest, and secrets safe with environment variable references.

Where the dsh-notifier DSH plugin fits

Get instant notifications when your DSH agent finishes a turn or encounters an error.
Approve agent actions (e.g., executing commands) from your phone while away from the desk.
Monitor long-running tasks with heartbeats and stop them if they stall, using the notification action button.
Chat with your agent remotely via Telegram, Feishu, or QQ to inject follow-up instructions.
Receive a daily digest of yesterday's notification traffic in a passive channel.

Who the dsh-notifier DSH plugin is for

DSH users who want to stay informed about agent activity on their mobile devices.
Developers building agent workflows that require human approval or remote interaction.
Teams using DSH in multi-agent setups needing centralized notification routing.

dsh-notifier DSH plugin limitations

Requires self-provided credentials (API tokens, webhook URLs, secrets) for each configured channel.
Web admin console is accessible only from 127.0.0.1 (loopback) and requires a Bearer token.
Some channels have rate limits, daily usage caps, or require a paid subscription (e.g., Pushover).
Inbound channels for remote approval/conversation are limited to six: Telegram, Feishu, QQ bot, WxPusher, WeChat iLink, and DingTalk.
Desktop notifications on Windows require the optional BurntToast PowerShell module.
The plugin is in active development (v0.5+) and features may change.

dsh-notifier DSH plugin: from the repository README

Quoted from the THEWOLFWALKER/dsh-notifier README, the upstream source of the dsh-notifier DSH plugin. Copyright remains with the original authors.

> **Your agent, in your pocket.** — 通知、审批、遥控，全在你的手机里。 **English** · [**简体中文**](README.zh-CN.md) ![DSH](https://img.shields.io/badge/DSH-DeepSeek%20Harness-1F6FEB?style=flat-square) ![Node.js](https://img.shields.io/badge/Node.js-22%2B-339933?style=flat-square&logo=node.js&logoColor=white) ![JavaScript](https://img.shields.io/badge/JavaScript-ESM-F7DF1E?style=flat-square&logo=javascript&logoColor=black) ![Cordis](https://img.shields.io/badge/Cordis-plugin-FF6B6B?style=flat-square) ![Zero deps](https://img.shields.io/badge/zero%20deps-000000?style=flat-square) ![Bilingual](https://img.shields.io/badge/bilingual-EN%2F%E7%AE%80%E4%BD%93-00A98F?style=flat-square) ![Channels](https://img.shields.io/badge/channels-25%2B-00B4D8?style=flat-square) ![npm version](https://img.shields.io/npm/v/dsh-notifier?style=flat-square&logo=npm&logoColor=white) ![tests](https://img.shields.io/badge/tests-718-brightgreen?style=flat-square) ![license](https://img.shields.io/badge/license-MIT-brightgreen?style=flat-square) ![awesome-dsh-plugin](https://img.shields.io/badge/awesome--dsh--plugin-listed-00B4D8?style=flat-square) ![omdsh workshop](https://img.shields.io/badge/omdsh-workshop-7C3AED?style=flat-

Read the full READMERepository license: MIT

dsh-notifier DSH plugin questions

How do I configure Telegram notifications?

Add a channel entry with type 'telegram' in your profile patch. Provide your bot token from BotFather and the chat ID where messages should be sent. The bot must be added to the chat first.

Can I approve agent actions from my phone?

Yes, use inbound channels like Telegram, Feishu, or QQ. When the agent requests approval, you'll receive a notification with buttons or a reply prompt. Silence never approves, so you must explicitly respond.

How do I stop a long-running task via notification?

In v0.5+, if the task runs longer than the heartbeat interval (default 15 min), a notification card with a stop button appears on Telegram and Feishu. Tap the button to send a cancel command to the agent.

Is the web admin console accessible over the internet?

No, by default it listens only on 127.0.0.1 for security. You can change the bind address, but it's recommended to use a reverse proxy with authentication if exposing it externally.

What channels support remote conversation with the agent?

Six inbound channels: Telegram, Feishu, QQ bot, WxPusher, WeChat iLink, and DingTalk. You can send plain text to follow up or inject, use '!' prefix to steer mid-turn, and a merge window reassembles rapid typing.