memory-context

version: "1.1.0" name: memory-context description: > Retrieve past learnings and analysis via csm CLI. Activate at session start or when facing a problem that might have been solved before. category: knowledge-management compatibility: Requires csm CLI v0.3.2+. Falls back to grep if unavailable. allowed-tools: Read Grep Glob license: MIT

Memory Context

Retrieve relevant past learnings, analysis outputs, and project knowledge using the csm (Chaotic Semantic Memory) CLI.

Note: csm uses Hyperdimensional Computing (HDC) — hash-based token matching, not semantic embeddings. It excels at keyword/lexical search and exact-match recall. For semantic similarity (synonyms, paraphrases), use external embedding models.

Prerequisites

# Cargo (recommended)
cargo install chaotic_semantic_memory --version 0.3.2 --bin csm

# npm alternative
npm install -g @d-o-hub/csm

Health Check

Run scripts/check_csm.sh to verify csm is installed and the memory index is accessible. Falls back to grep if unavailable.

When to Use

At session start to recall previous work
When facing a problem that might have been solved before
To retrieve specific findings from analysis/ or plans/

Indexing (Run Once)

# Index plans and analysis (keyword-level matching)
csm index-dir --glob "plans/**/*.md" --glob "analysis/**/*.md" --heading-level 2

# Index codebase knowledge
csm index-dir --glob "**/*.md" --heading-level 2

# Specify database location
csm init --database .git/memory-index/csm.db

Index stored in .git/memory-index/csm.db (per-clone, never committed). Tables use csm_ prefix (csm_concepts, csm_associations) for namespace isolation.

Querying

# Keyword/lexical query (HDC matching)
csm query "offline sync architecture" -k 5 --database .git/memory-index/csm.db

# JSON output for structured parsing
csm query "TRIZ contradiction offline availability" -k 3 --output json

# BM25+HDC hybrid search (v0.3.0+)
csm search "Turso sync" --hybrid -k 5

# With abstain threshold (v0.3.2+)
csm query "auth flow" -k 5 --abstain-threshold 0.3

CLI Commands (v0.3.2)

Command	Description
`csm init --database <path>`	Initialize memory database
`csm inject <concept>`	Add concept to memory
`csm probe <concept> -k <n>`	Find similar concepts
`csm query <text> -k <n>`	Natural language query
`csm search <text> --hybrid`	BM25+HDC hybrid retrieval
`csm index-dir --glob <pattern>`	Batch index directory
`csm export --output <file>`	Export memory snapshot
`csm import --input <file>`	Import memory snapshot

Token Budget

Use -k (top-k) to control output size. Default is 5 results.

Alternative Without csm CLI

If csm is not installed, use grep/find to search:

grep -r "offline sync" plans/ analysis/