sedimem.
Local-first personal AI memory: an append-only truth layer; everything else is rebuildable.
831tests
0runtime deps
12modules
v1.4.1current
System Architecture
Four Write Gates
Dual-Channel Read
LLM Derivation
Task Store
session:* forbids facts; close promotes only decision / gotcha, plus a handoff markdown.
memo session start
memo session checkpoint
memo session close
Task Ledger
memo session capture
memo session segments
memo session brief
memo session expand
memo session archive
memo brief --tier0
memo search
Five-Layer Gates
Memory Center
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
- v0.1 Truth layer + BM25 + gates
- v0.2 Read-only console + versioning
- v0.3 Layered views + injection tiers
- v0.4 Semantic channel + sanitization
- v0.5 DSH plugin + pages-verify
- v0.6 Session store + bulk import
- v1.0 14-module refactor + center
- v1.0.1 Graph usability + colors
- v1.0.2 Thinking / rebuild / lazy fix
- v1.0.3 Scope-ownership gate + CI fixes
- v1.0.4 Task stores in the console
- v1.0.5 Task page usability: two columns / 8-section checkpoint
- v1.1.0 Memory-center UI rebuild + task library management
- v1.2.0 Task context ledger: segments / brief / quarantine / archive
- v1.2.1 Brief readability / decision precision / capture default LLM
- v1.2.2 Q16 release-surface coverage + ledger docs
- v1.3.0 P0a foundation: CI/gates/docs follow CURRENT
- v1.3.1 Task-store terminology & MCP entry fix (one-shot
session:) - v1.4.0 P0b start: English README/site (English diagrams +
?lang=enUI) and site links - 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.