dsh-engram-bundle

DSH Engram Bundle

A DeepSeek Harness plugin that wires Engram persistent memory MCP into a profile and injects parent-agent memory rules.

Report an issue · View on npm · 简体中文

DSH Engram Bundle is a community-maintained plugin, not an official DeepSeek AI product.

Features

• Registers Engram as a stdio MCP server through @deepseek-ai/dsh-mcp-client.
• Starts engram mcp --tools=agent by default; override the binary with ENGRAM_BIN.
• Injects a minimal memory protocol into the parent agent via DSH systemPrompt.
• Skips child agents so memory is not saved twice.
• Does not write AGENTS.md into user directories.

Prerequisites

• A working DeepSeek Harness installation with dsh available in PowerShell.
• engram available on PATH, or ENGRAM_BIN pointing to the executable.
• Examples use the web profile; replace it with the target profile.
• Source installation and development require Node.js 20+.

Installation

Install from npm

Run this from any PowerShell directory. Install into the DSH profile through dsh plugin:

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
dsh plugin --profile web add @michengai/dsh-engram-bundle
dsh --profile web --dump-config

Restart DSH or reload the active profile. If a package mirror is behind, append --registry=https://registry.npmjs.org/.

Install from source

Use this for debugging or unpublished changes. The cloned directory becomes the plugin source path:

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
Set-Location D:\Repository\deepseek-harness-plugin
git clone https://github.com/MichengAI/dsh-engram-bundle.git
Set-Location .\dsh-engram-bundle
npm test
dsh plugin --profile web add .
dsh --profile web --dump-config

Then restart DSH or reload the active profile. dsh plugin ... add . reads and applies cordis.patch.yml; do not copy lib files by hand.

Configuration

Item	Default	Notes
MCP command	engram	Set ENGRAM_BIN when the binary is not on PATH.
MCP args	mcp --tools=agent	Uses Engram's agent tool surface.
Working directory	process.cwd()	Follows the current DSH working directory.
Prompt injection	Parent agent only	Child agents with parentSession receive an empty section.

Memory protocol

The plugin injects these parent-agent rules:

• Search existing memory first for continuation work (mem_context, then mem_search).
• Save after bug fixes, design decisions, configuration changes, or important discoveries (mem_save).
• Write a session summary before ending (mem_session_summary).
• Do not persist ordinary chat or throwaway notes.

The full protocol and MCP wiring live in the handoff docs.

Development

This repository keeps runtime source in lib and has no build step:

• lib\index.js: Host plugin that registers the systemPrompt section.
• lib\protocol.js: Parent-agent memory rules.
• test\memory-plugin.test.mjs: Injection behavior.
• test\package-contract.test.mjs: Package and patch contract.

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
npm test
npm run pack:check
dsh plugin --profile web add .

Verification

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
npm test
npm run pack:check

prepublishOnly runs the tests before publish.

Project docs and license

Start at the handoff index. This project uses Apache License 2.0.