Ntfyx for DeepSeek Harness
中文 · Ntfyx · Install the CLI
Send task notifications and rich reports from DeepSeek Harness (dsh) to your phone. Ask a question, answer with buttons or text on iPhone, Android or a phone-authorized Web Inbox, and let the local Ntfyx CLI verify and claim the reply before the agent continues.
Plugin 0.1.0 · Ntfyx CLI 0.6.0+ · DSH 0.2.2-alpha.2 · Node.js 24.9+. DSH is in developer preview; this initial release declares only the DSH version it was checked against.
Install
Install the signed Ntfyx CLI without configuring another agent:
curl -fsSL https://ntfyx.me/install.sh | bash
export PATH="$HOME/.local/bin:$PATH"
ntfyx version --json
ntfyx connect
connect is needed for protected notifications and phone questions. Scan and authorize the connection from Ntfyx 1.8.0+ and select a protected Topic. Public Topic operations require no pairing.
Install the native bundle in the DSH profile you use:
dsh plugin --profile web add dsh-plugin-ntfyx@0.1.0
dsh web
Replace web with your profile name. If you launch DSH through npx, use npx @deepseek-ai/dsh@0.2.2-alpha.2 in place of dsh. DSH's plugin command also requires pnpm on PATH. Restart an already running profile after installation.
GitHub is an alternative package source; the bundle ships ready to use and has no build or installation scripts:
dsh plugin --profile web add github:KaylaONeal/dsh-plugin-ntfyx#v0.1.0
Tell DSH:
Read the ntfyx skill, then use Ntfyx to ask me a test question on my phone. Use Ntfyx for decisions and send a completion notification for this task.
An actual signed reply returning to the waiting agent verifies the phone workflow. A successful installation alone does not verify phone delivery.
Discover in the DSH interface
If you enable DSH's experimental Custom plugin indexes bundle, open Plugins → Discover → Add index source and add:
https://raw.githubusercontent.com/KaylaONeal/dsh-plugin-ntfyx/main/plugins.json
This is the Ntfyx-maintained index. It shows the native bundle with its icon, English/Chinese details and install confirmation; it does not make the plugin a DeepSeek-maintained Official bundle.
What the bundle provides
The native cordis.patch.yml starts your installed ntfyx mcp through DSH's official MCP client and registers the bundled ntfyx skill. The package includes English and Chinese plugin details and an icon for DSH's Plugins page. It contains no credentials, transcript uploader, hosted MCP endpoint or replacement approval engine.
| Capability | DSH tool |
|---|
| Protected notifications and rich reports | mcp__ntfyx__ntfyx_send |
| Phone questions | mcp__ntfyx__ntfyx_ask |
| Wait for and claim a verified answer | mcp__ntfyx__ntfyx_result |
| Cancel a pending question | mcp__ntfyx__ntfyx_cancel |
| Local rich-message validation | mcp__ntfyx__ntfyx_validate_message |
| Public Topic notifications and reads | mcp__ntfyx__ntfyx_public_send, mcp__ntfyx__ntfyx_public_read |
| Paired Inbox usage | mcp__ntfyx__ntfyx_usage |
Use one session_id for the current task's updates and questions. Pending questions keep the same request_id; continue only after status: "answered" and consumption.claim_acquired: true. For a confirmation, only response.value: "allow" permits the described action. Denial, timeout, cancellation and failed verification never mean consent. Existing authorization and the user's channel choice remain in force.
Completion notifications are agent tool calls. This version has no automatic lifecycle hooks, does not intercept native DSH questions, and does not approve DSH tool-permission prompts. DSH's normal permission policy still controls tool execution.
Update or remove
dsh plugin --profile web update --latest dsh-plugin-ntfyx
dsh plugin --profile web remove dsh-plugin-ntfyx
Restart the profile. Removing the bundle preserves your Ntfyx CLI and paired credentials.
For a GitHub installation, install the new release tag with add github:KaylaONeal/dsh-plugin-ntfyx#vNEW_VERSION; updating a pinned tag does not select a newer tag.
Verify locally
From a checkout of this repository, with Node 24+ and npm installed:
npm test -- --ntfyx /absolute/path/to/ntfyx
The test installs a small set of official DSH runtime packages with install scripts disabled, packs this bundle, and boots its real patch in an isolated profile. It checks Ntfyx MCP discovery, local message validation and installed skill discovery. It uses an unpaired temporary identity store, calls no model, and sends no notification. Evidence is saved under .local/dsh-plugin-test/. Use --runtime PATH to reuse a runtime created by an earlier run.
Troubleshooting
Run ntfyx doctor and ntfyx version --json in the environment that launches DSH. Desktop launchers must also have ntfyx on PATH. The bundle's MCP entry ID is ntfyx-mcp; its transport timeout allows a 45-second Ntfyx question/result wait. If the CLI is absent or cannot start, DSH logs an MCP connection error and continues; fix PATH and restart. Avoid adding a second MCP client named ntfyx in the same scope.
DSH's --dump-config can inspect composition without starting plugins:
dsh --profile web --dump-config
That command does not prove MCP connectivity or phone delivery. Linux runtime checks and local rich-message validation are recorded in the release notes. Other operating systems and real DSH-to-phone delivery require separate acceptance.
Distribution and privacy
This is the Ntfyx-maintained community plugin for DSH. DeepSeek currently distributes its own Official bundles and ships no default third-party plugin index. The upstream contribution guide recommends publishing a GitHub repository with the dsh-plugin topic and currently does not accept external pull requests. See the official contribution guide and plugin-index guide.
Protected messages and answers are encrypted on devices; the service handles routing metadata and ciphertext. Public Topic messages are visible to the service and anyone who knows the Topic ID, are not end-to-end encrypted, and cannot authorize actions. The user must explicitly accept the public-content terms before the first public send; a Topic link is not consent.
The bundle configuration and skill are MIT licensed. The companion CLI, apps and hosted service follow their own license and service terms. This repository does not contain Ntfyx's application core or a self-hosting distribution. Privacy · Support.
