dsh-wsl-mail: Read-Only Email Viewing with himalaya/notmuch

In the plugin-based ecosystem of DeepSeek Harness (DSH), adding email reading capabilities to agents or tools is a common requirement. However, integrating email protocols directly usually involves sensitive configuration information. The dsh-wsl-mail plugin wraps himalaya and notmuch, providing read-only mailbox listing and search features, suitable for scenarios that do not require sending email.

Positioning and Core Features¶

This is a DSH plugin that runs in a WSL environment and is maintained by user 173787247. It does not provide the ability to send or delete emails; it focuses on listing and searching.

The main commands provided include:

mail_status: checks whether the CLI tools are available.
mail_list: calls himalaya to retrieve the envelope list.
mail_notmuch: calls notmuch to search emails.

Installation and Activation¶

To install this plugin, you need to use the DSH CLI command. Make sure your environment already has DSH installed.

Run the installation command:

dsh plugin --profile web add github:173787247/dsh-wsl-mail

(Optional) If you use the dsh-wsl-kit suite to manage plugins, you can run the following command to link them in bulk:

bash dsh-wsl-kit/scripts/link-linux-plugins.sh

Configuration Notes¶

Before using it, you must configure himalaya and notmuch yourself. The plugin does not handle sensitive information such as IMAP passwords, so do not paste passwords in plaintext in configuration files.

Feature limitations: The plugin supports read-only operations only; it does not send or delete email.
Environment dependencies: The plugin runs with the permissions of the current DSH process. Before installation, it is recommended to review the source code and license.

Compatibility Notes¶

According to the package.json information, the current plugin version is 0.1.1. The version displayed at the top of the README is 0.1.0. The two are inconsistent; package.json should be treated as authoritative.

Minimum DSH version: ≥ 0.1.2 (Web UI one-time ?token=, Windows relay :3081).
Suite tier: This plugin is not included in the default install.sh, and it is also not included in the default KIT_SET=daily. It must be added manually.
Authoritative compatibility reference: The latest verification information is based on dsh-wsl-kit compatibility. The current suite tier is 0.2.0-rc.2.

Summary¶

dsh-wsl-mail is a lightweight read-only email plugin. It maps the features of himalaya and notmuch to DSH’s command set. For scenarios that require processing email summaries or searching for specific content in agents, this is a direct integration solution.