dsh-native-memory

Native, per-workspace long-term memory for DeepSeek Harness (dsh): facts and profiles stored on the harness's own storage-domain, cross-session recall through session-query FTS, approval-gated writes, and cited provenance — no external server, no extra runtime dependency.

⚠️ Installing a plugin runs third-party code on your machine with your own permissions. Review the source (src/) and the security model before installing.

Why this one

	dsh-hermes-memory	dsh-native-memory
Storage	~/.dsh/settings.yaml namespace	dedicated storage-domain unit (~/.dsh/storages/dsh_memory.json)
Scope	user-global, all projects	per workspace (exact-cwd authorization)
Write safety	silent, model-only	human approval gate + session-log audit
Recall	everything always injected (hard caps)	bounded always-on profile plus on-demand recall + FTS over past sessions
Dependencies	vendored imports into the harness checkout	none beyond zod + the harness itself

See docs/design.md for the full architecture and the competitive landscape analysis.

Install

dsh plugin --profile web add dsh-native-memory   # npm after release
dsh plugin --profile web add /path/to/this/repo  # from a checkout

Restart dsh web. The bundle enables session-query full-text search and adds the memory tools to every session. Details and configuration: docs/install.md.

Tools

Tool	Kind	Gate
memory_remember	add/update a fact in this workspace	approval
memory_edit	replace a fact	approval
memory_forget	archive a fact (soft delete)	approval
memory_recall	deterministic scan over this workspace's facts	none
memory_search	FTS over this workspace's past sessions	none
memory_profile	read the always-injected workspace profile	none

Every fact records its origin (sessionId, seq) — memory stays reconstructable from the lossless session log.

Development

pnpm install
pnpm build && pnpm typecheck && pnpm test

New contributors start at docs/handoff.md and docs/contributing.md. Chinese docs: README.zh.md.

License

MIT