Introduction

If your global directives and long-term memory are stored in $DSH_HOME/AGENTS.md, the usual practice was to exit the browser, open the file in a local file manager or editor to modify it, save it, and then return to the DeepSeek Harness Web.

dsh-plugin-agents-memory moves this action to the DSH Web settings page: without leaving the browser, you can read and edit the same global AGENTS.md file.

What is this

dsh-plugin-agents-memory is a DeepSeek Harness Web plugin maintained by Cocowwy. It adds a “Settings -> Global Memory” option in DeepSeek Harness Web for directly editing global AGENTS.md directives and memory content.

The license for this plugin is MIT.

Core Features

  • Adds “Settings -> Global Memory” in DeepSeek Harness Web.
  • Read and edit $DSH_HOME/AGENTS.md without leaving the browser.
  • Automatically creates an initial document with a basic structure when the file does not exist.
  • Saves using atomic writes and keeps file permissions at 0600.
  • Uses revision checks to prevent a modification in one browser tab from silently overwriting another tab.
  • Content size limit is 256 KiB.
  • The Host interface is fixed to operate on $DSH_HOME/AGENTS.md and only accepts requests from loopback addresses.

Requirements

  • DeepSeek Harness that supports Web profiles and client plugins
  • Node.js 20 or higher
  • Local web session (127.0.0.1 or ::1)

Installation and Usage

First, use the official install command to add the plugin to the DSH Web profile:

dsh plugin --profile web add "github:Cocowwy/dsh-plugin-agents-memory"

If you need to pin to a specific version, you can use the versioned command:

dsh plugin --profile web add "github:Cocowwy/dsh-plugin-agents-memory#v0.1.2"

After installation, restart the running dsh web, refresh the page, and go to “Settings -> Global Memory”.

If you want to install for local development, you can clone the repository and install using a local path:

git clone https://github.com/Cocowwy/dsh-plugin-agents-memory.git
dsh plugin --profile web add "/your/absolute/path/dsh-plugin-agents-memory"

After local installation, you also need to restart dsh web.

Typical Usage

  1. Open “Settings -> Global Memory”.

  2. Edit Markdown content in the page to save global directives or memory content.

  3. Click “Save”.

When saving, the plugin writes the content to:

$DSH_HOME/AGENTS.md

If DSH_HOME is not set in the current environment, the actual path is:

~/.dsh/AGENTS.md

If the target file does not exist, the plugin automatically creates an initial document with a basic structure when the page is opened, after which you can continue editing on the page.

Security and Limitations

This plugin targets a local development environment and is not a network document service. Do not expose the DSH Web service to untrusted networks.

The browser interface has the following limitations:

  • Only accepts loopback client requests.
  • Requires plugin-specific request headers.
  • Only supports GET and PUT.
  • Does not provide path parameters.
  • Host always resolves the target to $DSH_HOME/AGENTS.md.
  • Uses revision checks and atomic writes.
  • Rejects documents larger than 256 KiB.
  • Saved file permissions remain 0600.

Note that AGENTS.md will be used as context visible to the model. Do not save passwords, API keys, access tokens, or other sensitive information in the file.

The plugin runs with the permissions of the current dsh process and will write to local global configuration files. It is recommended to check the source code, dependencies, and license before installing.

Uninstall

If you need to remove the plugin, run:

dsh plugin --profile web remove dsh-plugin-agents-memory

Then restart dsh web.

Uninstalling the plugin will not delete $DSH_HOME/AGENTS.md. If you have already written global content through this plugin, the file content will still remain locally after uninstallation.

Related Links

GitHub Repository:

https://github.com/Cocowwy/dsh-plugin-agents-memory