dsh-gentle-engram

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

Contributing

Contributions, bug reports, documentation updates, and focused feature proposals are welcome. For the complete workflow, coding expectations, and pull request checklist, see CONTRIBUTING.md.

Before starting:

• Check existing issues and pull requests to avoid duplicate work.
• Open an issue first for larger changes so the approach can be discussed.
• Do not include secrets, personal Engram data, local database files, or machine-specific configuration in commits.

For a typical change:

1. Fork the repository and create a focused branch.
2. Install dependencies with pnpm install.
3. Make the smallest change that solves the problem, preserving existing TypeScript and Cordis patterns.
4. Run pnpm run typecheck and pnpm run build.
5. Open a pull request explaining what changed, why, and how it was validated.

Keep pull requests focused, avoid editing generated dist/ output directly, and do not include unrelated formatting or dependency changes. Please report suspected security vulnerabilities privately rather than in a public issue.

License

This project is released under the MIT License. See LICENSE for the complete license text.