Introduction

In DeepSeek Harness (DSH) development or usage scenarios, ending a session usually means context loss. To solve this problem, the dsh-maestro-memory plugin provides the ability to persist memory and to-do items across sessions. It stores data in ~/.dsh/memories, enabling the AI to maintain continuity between sessions.

What It Is

This is a DSH plugin that provides persistent cross-session memory and to-do tracking. It maintains the ~/.dsh/memories file. This plugin is maintained by ddtcorex.

Installation and Enablement

Before installation, ensure the environment meets the following requirements:
- Node.js 22+
- pnpm 11+
- the master branch of DSH deepseek-harness

To install the plugin, use the following command:

dsh plugin --profile web add github:ddtcorex/dsh-maestro-memory#<tag-or-sha>

The plugin includes the cordis.patch.yml configuration file, so it does not need to be added again during installation. This configuration file is used to define core plugin behavior, including parameters such as the memory directory, snapshot order, and write control.

Core Features

The plugin provides the following core features:

  • Multi-track memory management: Supports five memory tracks, including global, user, project, branch, and daily memory.
  • To-do item management: Provides the maestro_todo tool for managing cross-session to-do items.
  • Sensitive information filtering: The memory tool automatically filters sensitive information to avoid leaking API keys, passwords, and similar items.
  • Health checks: Provides a health check endpoint for monitoring the plugin’s running status.

Typical Usage

In a DSH environment, operations can be performed through the following tools:

  • Manage memory tracks: Use the memory command to add, view, or manage entries across the five tracks.
  • Manage to-do items: Use the maestro_todo command to manage the cross-session to-do list.
  • Repair memory data: If memory file corruption is detected, use the memory.repair command to repair entries, such as splitting stuck-together entries or removing duplicates.
  • Check health status: Visit the /dsh-maestro-memory-health endpoint to view the plugin’s status and statistics.

Notes

When using the plugin, note the following:

  • Version requirements: Ensure DSH is on the master branch of deepseek-harness, and that Node.js and pnpm meet the required versions.
  • Configuration changes: The writeGuard configuration is read during apply(); modifying this configuration requires restarting the DSH process.
  • Synchronization logic: The archive synchronization logic is relatively complex and requires consistent operations across all machines; otherwise, data inconsistency may occur.
  • Compliance: The plugin runs with the permissions of the current DSH process. Before installation, review the source code and license.

Brief Conclusion

dsh-maestro-memory solves the DSH context-loss problem by persisting data to files. It is suitable for scenarios that require long-term memory and task tracking. For more details, see the GitHub repository.