dsh-claude-mem
A DeepSeek Harness plugin that integrates claude-mem: query persisted cross-session memory, inject per-project context at session start, save manual memories, and drive session summarization — all through a local claude-mem worker's HTTP API.
It registers the model-facing tools mem_search, mem_timeline, mem_get_observations, mem_save, and mem_context, the mem-search skill, and the lifecycle hooks (agent/session-start context injection, optional tools/post-execute ingestion, optional agent/turn-stopping summarization). It is a single self-contained package with no monorepo-only dependencies.
Install
One-liner with npx (no global install — npx fetches the dsh launcher and
dsh plugin forwards add to pnpm in the target profile):
npx -y @deepseek-ai/dsh plugin --profile demo add @bleed00/dsh-claude-mem
If you already have dsh on PATH, the same command without npx:
dsh plugin --profile demo add @bleed00/dsh-claude-mem
npm (recommended — ships prebuilt lib/, no build permission needed):
npx -y @deepseek-ai/dsh plugin --profile demo add @bleed00/dsh-claude-mem
GitHub (sources; runs a prepare build on first install):
npx -y @deepseek-ai/dsh plugin --profile demo add github:Bleed00/dsh-claude-mem
A GitHub install fetches sources, not build output, so pnpm runs this package's prepare script to build from src/. pnpm ≥10 refuses to run a git dependency's prepare until it is allowlisted; the first add fails and points at the fix — copy the exact package key pnpm printed into the profile's pnpm-workspace.yaml:
allowBuilds:
'@bleed00/dsh-claude-mem': true
then re-run the add. Treat that allowance as permission to run this package's code at install time; pin a commit for reproducible installs:
dsh plugin --profile demo add github:Bleed00/dsh-claude-mem#<sha>
Local checkout:
dsh plugin --profile demo add ./dsh-claude-mem
Requirements
- A DeepSeek Harness installation with
dsh on PATH.
- The claude-mem worker already running on its default port (
http://127.0.0.1:37700). Override with the baseUrl config or the DSH_MEM_BASE_URL environment variable.
Config
| Field | Default | Description |
|---|
baseUrl | http://127.0.0.1:<37700 + uid % 100> | Worker base URL. |
timeoutMs | 30000 | Per-request timeout (ms). |
dedupe | true | Collapse duplicate observations in query results (content fingerprint, never identity). |
platformSource | unset | Optional platform filter; omitted = search all memory. |
project | unset | Project name; defaults to the session cwd basename. |
injectContext | true | Inject session-start context. |
ingest | false | Save observed tool results as memories. |
summarize | false | Summarize sessions on turn stop. |
toolFilter.names | read, write, edit, bash | Tools observed when ingest is true. |
Platform scoping is a signal, never a restriction: default requests are unfiltered, and platformSource only adds an opt-in filter.
Duplicate handling
The worker can persist the same observation many times (a boilerplate "session
initiated" record, or a re-run tool result) — identical content, different id.
With dedupe: true (the default), query results collapse those copies: an
observation's content fingerprint is built from title + subtitle +
text + narrative + facts (normalized), so two entries that merely share a
generated title but differ in narrative are kept. The first copy (lowest id)
is retained. Structured results (mem_get_observations) are deduplicated by
fingerprint; rendered index/text results are deduplicated by exact rendered
row. Set dedupe: false to see the raw, unfiltered results.
Example override in the profile's cordis.patch.yml
- id: claude-mem
config:
baseUrl: http://127.0.0.1:37700
platformSource: dsh
ingest: true
summarize: true
Tools
| Tool | Purpose |
|---|
mem_search | Search memory; returns an index (ids, titles, types). |
mem_timeline | Get context around one observation. |
mem_get_observations | Fetch full details for ids. |
mem_save | Save one manual memory. |
mem_context | Render the worker's session-start context text. |
The mem-search skill teaches the model the search → filter → fetch workflow that keeps token usage low.
Development
pnpm install
pnpm run build # tsc + tsdown → lib/index.js
pnpm test
The package targets Node ≥ 20.12, TypeScript 6.0, and is authored against the @deepseek-ai/* framework packages (cordis, schemastery, dsh-tools, dsh-llm, dsh-skill, dsh-agent).
License
Apache-2.0 © Bleed00
