Skip to content
Back to search

dsh-deepcanary

Know when your DeepSeek Harness tasks need you. Local alerts, quiet notifications, and a task inbox.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/oscar-williams--dsh-deepcanary/badge.svg)](/listings/oscar-williams--dsh-deepcanary)

HTML

<a href="/listings/oscar-williams--dsh-deepcanary"><img src="/api/listings/oscar-williams--dsh-deepcanary/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Desktop

Open DSH **Plugins**, use its official package installation control, and enter:

dsh-deepcanary@0.1.4-rc.1

Apply the change using the manager's enable/restart instructions. Save active work before restarting. Desktop manages its own reserved profile; use the application's manager for installation, update and removal.

WebUI with the DSH CLI

Check that your installed host is DSH `0.2.0-rc.2`, then install into the **web** profile:

dsh --version
dsh plugin --profile web add dsh-deepcanary@0.1.4-rc.1
dsh --profile web

Open the authenticated URL printed by DSH. The fixed package version makes installation reproducible. You can also pass the downloaded `.tgz` from [GitHub Releases](https://github.com/Oscar-Williams/dsh-deepcanary/releases/tag/v0.1.4-rc.1) to `plugin add`. Use the official npm registry if a mirror has not synchronized the release.

Existing DSH source checkout

From a built checkout at `dsh-v0.2.0-rc.2` (commit `639ed015397290b3745d163aafe02ffee4aa3f84`), run the checkout's CLI script:

npx --yes pnpm@11.7.0 run dsh plugin --profile web add dsh-deepcanary@0.1.4-rc.1
npx --yes pnpm@11.7.0 run dsh --profile web

Follow DSH's [source setup instructions](https://github.com/deepseek-ai/deepseek-harness/tree/dsh-v0.2.0-rc.2) to prepare that checkout. The plugin repository uses its own npm lockfile; its development commands are in [development](docs/development.md).

Update and remove

To update the Web profile, rerun the fixed-version installation command and follow DSH's reload instructions. To remove it:

dsh plugin --profile web remove dsh-deepcanary

In a source checkout, use `npx --yes pnpm@11.7.0 run dsh plugin --profile web remove dsh-deepcanary`. Removal preserves the host profile, sessions and saved reminder data.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 167 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <h1 align="center">DeepCanary</h1>
  2. <p align="center">A task inbox and local notifications for DeepSeek Harness.</p>
  3. <p align="center">
  4. <a href="https://www.npmjs.com/package/dsh-deepcanary"><img src="https://img.shields.io/npm/v/dsh-deepcanary/latest?label=npm&amp;color=2563eb" alt="npm version"></a>
  5. <a href="https://github.com/Oscar-Williams/dsh-deepcanary/actions/workflows/ci.yml"><img src="https://github.com/Oscar-Williams/dsh-deepcanary/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI"></a>
  6. <a href="docs/compatibility.md"><img src="https://img.shields.io/badge/DSH-RC5%20%7C%20alpha.3%2B-2563eb" alt="DSH compatibility"></a>
  7. <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-2563eb" alt="MIT license"></a>
  8. </p>
  9. <p align="center"><a href="README.zh-CN.md">简体中文</a> · <a href="docs/README.md">Documentation</a> · <a href="CHANGELOG.md">Changelog</a> · <a href="https://github.com/Oscar-Williams/dsh-deepcanary/releases">Releases</a></p>
  10. DeepCanary groups task updates in **Pending**, **Snoozed**, and **Activity**. It reminds you when DSH needs an answer or approval, keeps routine completions in Activity, and returns you to the corresponding session.
  11. <p align="center"><img src="assets/deepcanary-panel-en.png" width="880" alt="DeepCanary inbox with task list and details"></p>
  12. [Install](#install) · [Use](#use) · [Notifications](#notifications) · [Update or remove](#update-or-remove) · [Compatibility](#compatibility) · [Troubleshooting](#troubleshooting) · [Security](#security-and-privacy) · [Contributing](#contributing) · [Acknowledgments](#acknowledgments) · [License](#license)
  13. ## Install
  14. DeepCanary **0.1.9-rc.1** requires DSH `0.2.1-rc.5` or `0.2.2-alpha.3` and later. Check the [Node.js requirements for WebUI](#compatibility) before installing. Windows Desktop includes its own runtime. [Install DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness#readme).
  15. ### Windows Desktop
  16. 1. Open **Plugins → Add plugin → Install a third-party plugin**.
  17. 2. Enter `dsh-deepcanary@0.1.9-rc.1` under **Package name or address** and choose **Install**.
  18. 3. Follow any restart prompt, then open **DeepCanary** from the left sidebar.
  19. ### WebUI
  20. Stop the running DSH WebUI server. Run these commands in your terminal.
  21. ```sh
  22. dsh plugin --profile web add dsh-deepcanary@0.1.9-rc.1 --registry=https://registry.npmjs.org/
  23. dsh web
  24. ```
  25. Open **DeepCanary** from the sidebar once WebUI starts.
  26. <details>
  27. <summary>Use a custom DSH data directory or profile</summary>
  28. If you start DSH with another profile, replace `web` in both commands with that name. If your launch command sets `DSH_HOME`, set it to the same directory in your terminal before installing, updating, or removing the plugin.
  29. PowerShell
  30. ```powershell
  31. $env:DSH_HOME = "<existing DSH data directory>"
  32. ```
  33. Bash or Zsh
  34. ```sh
  35. export DSH_HOME="<existing DSH data directory>"
  36. ```
  37. </details>
  38. <details>
  39. <summary>Install from a downloaded package</summary>
  40. Download the tgz and `SHA256SUMS` from the [GitHub release](https://github.com/Oscar-Williams/dsh-deepcanary/releases/tag/v0.1.9-rc.1). Run one of these commands from the download directory and compare the result with the package entry in `SHA256SUMS`.
  41. ```powershell
  42. Get-FileHash ./dsh-deepcanary-0.1.9-rc.1.tgz -Algorithm SHA256
  43. ```
  44. ```sh
  45. shasum -a 256 ./dsh-deepcanary-0.1.9-rc.1.tgz
  46. ```
  47. For WebUI, stop the server and run the commands below from the download directory. The package manager may still download dependencies from npm.
  48. ```sh
  49. dsh plugin --profile web add ./dsh-deepcanary-0.1.9-rc.1.tgz --registry=https://registry.npmjs.org/
  50. dsh web
  51. ```
  52. For Windows Desktop, open DSH once to initialize its profile, then choose **Application → Quit**. Open PowerShell in `resources/runtime/cli/bin` under the application directory. If you use a custom `DSH_HOME`, set it as shown above. Replace the placeholder with the full path to the downloaded package, run the command, and reopen DSH.
  53. ```powershell
  54. .\dsh.cmd plugin --profile desktop add "<full path to dsh-deepcanary-0.1.9-rc.1.tgz>" --registry=https://registry.npmjs.org/
  55. ```
  56. </details>
  57. ## Use
  58. | View | What you'll find |
  59. | --- | --- |
  60. | **Pending** | Questions, approvals, and task updates that need attention |
  61. | **Snoozed** | Reminders scheduled for later |
  62. | **Activity** | Routine completions, context compaction, and tasks you stopped |
  63. Select a reminder to see its details. Use the DSH button to open the session and reply or approve there. Choose **More actions → Acknowledge** to clear the reminder from Pending, or **Snooze** to schedule it for later.
  64. Drag the title bar to move the panel and drag any edge or corner to resize it. Drag the divider to adjust the list width. The **Layout** menu lets you dock, expand, restore, or reset the panel. DeepCanary remembers the layout on this device. In narrow windows, the list keeps its scroll position when you return from a reminder.
  65. For keyboard control, choose move or resize from **Layout**. Use the arrow keys to adjust the panel, hold Shift for larger steps, press Enter to confirm, or press Escape to cancel.
  66. ## Notifications
  67. Open **Alert settings** from the inbox. Set the minimum alert level, quiet hours, and the hourly limit for C2 interruptions. C3 reminders can still appear during quiet hours and after the C2 limit is reached.
  68. | Level | Meaning |
  69. | --- | --- |
  70. | **C3** | DSH is waiting for an answer or approval before it can continue |
  71. | **C2** | An error or unusual task state needs checking |
  72. | **C1** | A routine update is available in Activity |
  73. In WebUI, allow notifications for your DSH site and leave a DSH tab open. In Windows, allow notifications from your browser or DeepSeek Harness. The desktop app can receive notifications while minimized or hidden if it is still running.
  74. Click a notification to return to the reminder and session. Respond to questions and approvals in DSH to continue the task.
  75. ## Update or remove
  76. To replace an earlier version on Windows Desktop, uninstall DeepCanary from **Plugins**, then add `dsh-deepcanary@0.1.9-rc.1` in the same DSH app. Follow any restart prompts. To remove the plugin, stop after uninstalling.
  77. For WebUI, stop the server and repeat the [installation commands](#webui). Use the same DSH data directory and profile to keep your settings and reminders.
  78. To remove DeepCanary from WebUI, stop the server, run the following command, then restart WebUI. Replace `web` if you use another profile.
  79. ```sh
  80. dsh plugin --profile web remove dsh-deepcanary
  81. ```
  82. ## Compatibility
  83. | Tested DSH version | Platforms | Node.js for WebUI |
  84. | --- | --- | --- |
  85. | `0.2.1-rc.5` | WebUI and Windows Desktop | `^22.19.0 \|\| >=24.0.0` |
  86. | `0.2.2-alpha.3` | WebUI and Windows Desktop | `>=24.9.0` |
  87. Later DSH versions can install this package. Check the Node.js requirement for your DSH version. [Compatibility details](docs/compatibility.md).
  88. ## Troubleshooting
  89. | Problem | What to check |
  90. | --- | --- |
  91. | DeepCanary is missing | Check **Plugins** in the DSH app you use. For WebUI, confirm the data directory and profile match your launch command. Restart if prompted. |
  92. | DSH installs an older version | Enter `dsh-deepcanary@0.1.9-rc.1` and use the official npm registry, `https://registry.npmjs.org/`. |
  93. | Installation is rejected | Check the DSH and Node.js versions in [Compatibility](#compatibility). |
  94. | No system banner appears | Check that DSH is running, then check browser permission, Windows Do Not Disturb, and [alert settings](#notifications). |
  95. | A session cannot be opened | Check whether the session still appears in your current DSH app. You can still read the reminder in the inbox. |
  96. | The panel is hard to reach | Select **Layout → Reset layout**. |
  97. | Reminder state cannot be saved | Click **Refresh status** in the inbox to retry. If it fails again, check that the account running DSH can write to its profile directory. |
  98. For ordinary bugs, include your DSH and DeepCanary versions, operating system, and steps to reproduce. Remove private content before posting. [Report an issue](https://github.com/Oscar-Williams/dsh-deepcanary/issues).
  99. ## Security and privacy
  100. DeepCanary saves reminder metadata in your DSH data directory and uses local rules to decide when to notify you. Read about the files it saves and how notifications use them. [Data and privacy](docs/security.md).
  101. Use the private reporting channel for vulnerabilities. [Security policy](SECURITY.md).
  102. ## Contributing
  103. See how to set up the project, run tests, and submit a change. [Contributing](CONTRIBUTING.md) · [Documentation](docs/README.md).
  104. ## Acknowledgments
  105. Thanks to the DeepSeek Harness team for the plugin APIs, and to the community directories that list DeepCanary. [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) · [dsh.works plugin directory](https://github.com/dshworks/awesome-dsh-plugins) · [Awesome DeepSeek Harness Plugins](https://github.com/jqueryscript/awesome-dsh-plugins).
  106. ## License
  107. Licensed under the [MIT License](LICENSE). Copyright © 2026 Oscar Williams.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.