Back to directory

engramory

Curated pickMaintenance: Active

tinqiao-oss/engramory

A portable memory protocol for AI agents — load it as standing rules; a curation discipline + reference spec + optional cap hook.

View on GitHub
$ dsh plugin add engramory

188

stars

11

forks

Python

Language

MIT

License

2026-06-13

Created

2026-09-08

Last push

A dsh skill that gives Harness a local, file-based memory discipline (markdown plus index), installed via the dsh init helper; needs dsh 0.2.1+ and Python 3.9+.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-08-22

License

MIT

01What can it help you accomplish?

  • Give DeepSeek Harness a disciplined, local, file-based memory protocol (one fact per markdown file plus an always-loaded index)

    A marked block in $DSH_HOME/AGENTS.md and a skill under <DSH_HOME>/skills/engramory, plus a separate .engramory-memory/ store the model follows as standing rules

    DSH users who want a zero-infrastructure, human-readable agent memory discipline instead of a vector or graph DB

02How to install into DeepSeek Harness

Prerequisites

  • Python 3.9+
  • DeepSeek Harness dsh 0.2.1 or later
  • The engramory repo cloned locally

Installation steps

  1. 01

    Clone the repo and cd into it

  2. 02

    Run `python tools/engramory_init.py dsh --install-skill` (defaults to $DSH_HOME; use --project-root for a project-local install)

  3. 03

    Restart dsh; the protocol loads as standing rules via $DSH_HOME/AGENTS.md

Verify the integration

Not specified by the author

03DSH integration and capability boundaries

DSH integrationNative runtime

DSH integration via a skill installer: `python tools/engramory_init.py dsh --install-skill` writes an Engramory block into $DSH_HOME/AGENTS.md and installs the protocol under the dsh user skill root.

04Who is it for? When not to use it?

Good for

  • DSH users who want a zero-infrastructure, human-readable agent memory discipline instead of a vector or graph DB

Not for

  • Install dsh 0.2.1 or later. On dsh 0.2.0 the skill installs but never activates (issue 8, older Cordis inject syntax); the preview-era cannot-install-third-party-plugins bug is fixed upstream in rc.7.
  • The index cap is best-effort, not a global write guard: shell tools (Bash or PowerShell), MCP file tools, external editors, and sync clients bypass it. It is experimental (0.10.0); do not rely on it as a mandatory, cross-agent memory layer yet.

05Compatibility, maintenance and safety notes

  • Install dsh 0.2.1 or later. On dsh 0.2.0 the skill installs but never activates (issue 8, older Cordis inject syntax); the preview-era cannot-install-third-party-plugins bug is fixed upstream in rc.7.
  • The index cap is best-effort, not a global write guard: shell tools (Bash or PowerShell), MCP file tools, external editors, and sync clients bypass it. It is experimental (0.10.0); do not rely on it as a mandatory, cross-agent memory layer yet.
  • Engramory is not a database, framework, or relevance-loaded skill - memory is plain-text markdown files you can open, edit, and diff; the live store is git-ignored.
2026-06-132026-08-20v0.10.0

MIT - actively maintained (latest release v0.10.0, 2026-08-20)

06Frequently asked questions

How do I install it for dsh?

Clone the repo, then run `python tools/engramory_init.py dsh --install-skill` (defaults to $DSH_HOME; add --project-root for a project-local install). Restart dsh so the block in $DSH_HOME/AGENTS.md loads.

Which dsh version is required?

dsh 0.2.1 or later. On 0.2.0 the skill installs but never activates (issue 8); the preview-era cannot-install-third-party-plugins bug is fixed in rc.7.

Is it a database?

No - memory is plain-text markdown files (one fact per file) plus one always-loaded index. No database, embeddings, or server; the live store is git-ignored.

Is the index cap a hard guard?

No - it is best-effort. Shell tools (Bash or PowerShell), MCP file tools, external editors, and sync clients bypass it. Engramory is experimental (0.10.0); do not treat it as a mandatory cross-agent memory layer yet.

08Data and sources

  • Author-claimedgithub.com39efc183a55c…

    An opinionated, zero-infrastructure memory *protocol* for small-scale, local, file-based agent memory

  • Author-claimedgithub.com39efc183a55c…

    python tools/engramory_init.py dsh --install-skill

  • Author-claimedgithub.com39efc183a55c…

    It writes a marked Engramory block into `$DSH_HOME/AGENTS.md` (dsh agent-instructions plugin)

  • Author-claimedgithub.com39efc183a55c…

    Install **0.2.1 or later**: the preview-era cannot-install-third-party-plugins bug is fixed upstream (rc.7)

  • Author-claimedgithub.com39efc183a55c…

    a separate `.engramory-memory/` store.

  • Author-claimedgithub.com39efc183a55c…

    Memory is a folder of small, human-readable markdown files plus one always-loaded index.

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-22. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.