CLI Commands (15)¶

all commands available via engram <command>.

memory operations¶

ingest¶

engram ingest <paths...> [-j JOBS] [--no-queries]

ingest files or directories. supports markdown, plaintext, JSON (Claude Code, ChatGPT, Slack), PDF. -j for parallel extraction. --no-queries skips hypothetical query generation.

search¶

engram search <query> [-k TOP_K] [--debug] [--rerank] [--json]

hybrid search across all layers. --debug shows per-stage breakdown. --rerank enables cross-encoder. --json for machine-readable output.

remember¶

engram remember <content> [--source SOURCE] [--layer LAYER] [--importance IMPORTANCE]

store a memory directly. default layer is episodic, default importance 0.7.

entity¶

engram entity <name> [--graph]

look up an entity. --graph shows the relationship graph and 2-hop traversal.

maintenance¶

consolidate¶

engram consolidate

run the dream cycle — cluster, summarize, peer cards, cross-domain bridges, belief probing, drift detection, archival.

drift¶

engram drift [--search-roots DIRS] [--project-root DIR] [--fix] [--dry-run] [--json] [--no-functions]

check memory drift against filesystem. --fix auto-invalidates dead refs. --dry-run previews fixes.

patterns¶

engram patterns [--hours N] [--threshold N] [--dry-run]

extract reusable procedural patterns from recent session activity.

index management¶

index¶

engram index rebuild    # full HNSW index rebuild
engram index status     # show index size, vector count, last built

reembed¶

engram reembed [--batch-size N] [--dry-run]

re-embed all memories with the current model. use after switching embedding models.

data management¶

export¶

engram export <output> [--layer LAYER] [--include-embeddings]

export to JSON or JSONL. --include-embeddings adds base64 vectors for portable backup.

import¶

engram import <input> [--skip-duplicates]

restore from exported file. --skip-duplicates skips memories with matching content hash.

watch¶

engram watch <path> [--interval SECONDS]

poll a directory for new/changed files and auto-ingest. default 30s interval.

server¶

serve¶

engram serve --web [--port PORT]      # web dashboard (default 8420)
engram serve --mcp                     # MCP server (stdio, for Claude Code)
engram serve --mcp-sse [--port PORT]  # MCP server (HTTP/SSE, default 8421)

info¶

status¶

engram status

memory counts by layer, entities, relationships, DB size, ANN index status.

demo¶

engram demo [--keep] [--web] [--port PORT]

interactive walkthrough with sample data. --keep preserves the demo database. --web starts the dashboard.