sedimem.

Local-first personal AI memory: an append-only truth layer; everything else is rebuildable.

831tests 0runtime deps 12modules v1.4.1current
sedimem hero banner
The truth layer ~/.memo/items is append-only; indexes, views and derivations can all be rebuilt.

System Architecture

Full architecture: clients → interface layer → MemoryService → 14 modules → data layer
Clients → interface layer → MemoryService → 14 modules → data layer; ①②③ mark the main paths.

Four Write Gates

Four write gates
schema → sanitization → dedupe (Dice 0.15 recall / 0.85 match) → conflict ruling (superseded / disputed).

Dual-Channel Read

Read path: BM25 ± semantic → RRF → basis/degraded
BM25 ± semantic → RRF fusion (k=60); every result carries a basis, degrading to "degraded" when semantics are unavailable.

LLM Derivation

LLM derivation layer: outbox → sidecar
Off by default: write → outbox → LlmPort → derived sidecar. Full rebuild of 33 records ≈1m50s, <¥0.02.

Task Store

Task store lifecycle
Keyed by task, not by chat session — multiple agents can hand off one task. session:* forbids facts; close promotes only decision / gotcha, plus a handoff markdown.
memo session start memo session checkpoint memo session close

Task Ledger

Task page: one temporary memory store per task
The transcript is folded into replayable segments — nothing lost when the session closes, original text restorable by anchor. Segments never enter the truth layer; text is redacted and injection-like segments are quarantined.
memo session capture memo session segments memo session brief memo session expand memo session archive memo brief --tier0 memo search

Five-Layer Gates

Five-layer quality gates
Quality 15 + security 9 + coverage + docs-drift + pages-verify; 870 tests, eval I1–I56.

Memory Center

Today page
Today: four change cards + timeline.
Graph page
Graph: kind filter + force layout.
Hygiene page
Hygiene: pending curation clusters + trends.

Nine pages: Today / Graph / Search / Hygiene / Edit / Import / Task / Handoff / Settings. Start with memo serve --port 7788; add --write to enable editing.

Three Clients

All three clients share one stdio MCP (10 memory_* + 5 memory_session_* tools) and one MEMO_HOME.

# DSH: ~/.dsh/profiles/<profile>/cordis.patch.yml
- insert:
    - id: memory-sedimem
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: memo
        transport: stdio
        command: /opt/homebrew/bin/node
        args: ['/ABS/PATH/versions/v1.4/src/mcp/server.js']
        env: { MEMO_HOME: '$HOME/.memo' }
        toolCallTimeoutMs: 15000
# Codex CLI: ~/.codex/config.toml
[mcp_servers.memo]
command = "/opt/homebrew/bin/node"
args = ["/ABS/PATH/versions/v1.4/src/mcp/server.js"]
enabled = true
[mcp_servers.memo.env]
MEMO_HOME = "$HOME/.memo"
# Claude Code
claude mcp add --scope user memo -e MEMO_HOME=$HOME/.memo -- \
  /opt/homebrew/bin/node /ABS/PATH/versions/v1.4/src/mcp/server.js

Version Timeline

  1. v0.1 Truth layer + BM25 + gates
  2. v0.2 Read-only console + versioning
  3. v0.3 Layered views + injection tiers
  4. v0.4 Semantic channel + sanitization
  5. v0.5 DSH plugin + pages-verify
  6. v0.6 Session store + bulk import
  7. v1.0 14-module refactor + center
  8. v1.0.1 Graph usability + colors
  9. v1.0.2 Thinking / rebuild / lazy fix
  10. v1.0.3 Scope-ownership gate + CI fixes
  11. v1.0.4 Task stores in the console
  12. v1.0.5 Task page usability: two columns / 8-section checkpoint
  13. v1.1.0 Memory-center UI rebuild + task library management
  14. v1.2.0 Task context ledger: segments / brief / quarantine / archive
  15. v1.2.1 Brief readability / decision precision / capture default LLM
  16. v1.2.2 Q16 release-surface coverage + ledger docs
  17. v1.3.0 P0a foundation: CI/gates/docs follow CURRENT
  18. v1.3.1 Task-store terminology & MCP entry fix (one-shot session:)
  19. v1.4.0 P0b start: English README/site (English diagrams + ?lang=en UI) and site links
  20. v1.4.1 Periodic auto-capture: 60s scan of open tasks; 30k context segments

Rule: X.Y gets a new directory (currently versions/v1.4), X.Y.Z patches in place; current version v1.4.1.

中文 · English

This is the English version; the Chinese page is authoritative.