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