Back to directory

causal-memory

Curated pickMaintenance: Active

jingxuanc/causal-memory

Causal memory layer for AI agents — MCP server that records decision→outcome relationships. Survives compaction.

View on GitHub
$ dsh plugin add causal-memory

51

stars

3

forks

Rust

Language

Apache-2.0

License

2026-07-26

Created

2026-08-29

Last push

Apache-2.0 Rust MCP server + DeepSeek Harness plugin that gives agents a causal memory store surviving context compaction — facts, temporal state, and decision→outcome edges recalled by a hippocampus-style spreading-activation engine.

DSH integration

Ecosystem-related

Author-claimed

Safety audit

Unaudited

Last verified

2026-09-01

License

Apache-2.0

01What can it help you accomplish?

  • Give AI agents a causal memory that survives context compaction

    A SQLite-backed store of decision → outcome causal edges with hippocampus-style recall, so agents stop re-making the same mistakes after compaction

    Agent builders and engineers running DeepSeek Harness (dsh) who need long-term memory that compaction cannot erase

  • Stop agents from repeating past failures via causal intervention

    An intervention_query that fires a DANGER chain citing a previously recorded lesson before a risky action

    Teams whose agents take risky shell actions (e.g. `git push --no-verify`) and want guardrails drawn from prior lessons

02How to install into DeepSeek Harness

Not specified by the author

03DSH integration and capability boundaries

DSH integrationEcosystem-related

Ships as a DeepSeek Harness plugin (dsh-plugin/) with an MCP server backend

  • Causal memory store (decision → outcome)

    agent decisions and their observed outcomesdecision → outcome causal edges persisted on one SQLite store, surviving compaction

  • Hippocampus-style spreading-activation engine

    stored facts, temporal state, and causal edgesrecall of what happened, when, why, and the counterfactual 'what would happen if'

  • Inhibitory causal edges (models inhibition)

    causal relationshipsinhibitory as well as excitatory causal edges — the README claims it is the only memory system that models inhibition

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

Good for

  • Agent builders and engineers running DeepSeek Harness (dsh) who need long-term memory that compaction cannot erase
  • Teams whose agents take risky shell actions (e.g. `git push --no-verify`) and want guardrails drawn from prior lessons

05Compatibility, maintenance and safety notes

2026-07-262026-08-29v0.9.2

Apache-2.0 · README advertises v0.9.2-alpha (release v0.9.2, 368 tests); no safety audit claimed

06Frequently asked questions

How does causal-memory connect to DeepSeek Harness?

The repository ships a dedicated DeepSeek Harness plugin — the README carries a 'DSH plugin' badge linking to the dsh-plugin/ directory — and causal-memory also runs as an MCP server, so DeepSeek Harness can use it through MCP or the bundled DSH plugin.

Does causal memory survive context compaction in DeepSeek Harness?

Yes. The causal table lives outside the agent's context window, so compaction cannot touch it. The README's benchmark shows 100% causal-table recall after 5 compactions, versus 45% for plain text.

What does causal-memory actually store and recall?

It stores facts, temporal state, and decision → outcome causal edges on one SQLite store, recalled by a hippocampus-style engine using typed spreading activation (excitatory and inhibitory), Hebbian reinforcement, Q-value dynamics, and immutable SWR consolidation.

Can causal-memory stop my DeepSeek Harness agent from repeating past mistakes?

Yes. An intervention_query can fire a DANGER chain that cites a lesson the agent recorded earlier — for example, warning before a risky `git push --no-verify`.

08Data and sources

  • Author-claimedgithub.comc162eef51332…

    [![DSH plugin](https://img.shields.io/badge/deepseek--harness-plugin-blue.svg)](dsh-plugin/)

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-09-01. 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.