dsh-gentle-engram

Host Cordis plugin written in TypeScript that adds reliable Engram lifecycle behavior to DeepSeek Harness.

This integration requires Engram to be installed and available on your system; the bridge cannot work without it.

Design

• Uses the existing @deepseek-ai/dsh-mcp-client row for official Engram MCP stdio tools.
• Hooks DSH session start, inbound prompts, tool results, turn stopping, and agent disposal.
• Seeds relevant Engram context into the next model step.
• Saves prompts and filtered passive tool learnings asynchronously.
• Serializes per-session writes and waits for pending writes at turn boundaries.
• Closes Engram sessions and records a structured summary when an agent is disposed.
• Never accesses Engram SQLite directly and avoids forwarding likely secrets.

Installation from npm

Requirements:

• DeepSeek Harness with the dsh plugin command.
• Engram installed and available as engram in PATH.
• A configured DSH profile, such as web.

Install the alpha channel with:

npx @deepseek-ai/dsh plugin --profile web add dsh-gentle-engram@alpha

For the stable channel:

npx @deepseek-ai/dsh plugin --profile web add dsh-gentle-engram

Restart DSH after installation. The package is a Host bundle: its cordis.patch.yml owns both the MCP bridge and lifecycle plugin. Do not edit shipped presets or add a second manual Engram MCP row.

Check that Engram is available before starting DSH:

engram --version

Local development

pnpm install
pnpm run typecheck
pnpm run build