engram_remember
Store and persist facts, preferences, patterns, decisions, or outcomes across sessions. Automatically redacts secrets, deduplicates by similarity, and supports categorization and retrieval.
Instructions
Store a durable memory (fact/preference/pattern/decision/outcome) that persists across sessions. Every write is scanned for secrets (16+ patterns — OpenAI/Stripe/AWS/GitHub/Slack/Google keys, private keys, connection strings, JWTs): by default detected secrets are redacted to [REDACTED] before storage, or the write is rejected if auto-redaction is disabled. Category and entity are auto-extracted when omitted, a local embedding is generated, and the content is deduplicated against existing memories. Returns: the memory id plus an outcome — "created" (new), "merged" (0.92–0.95 cosine to an existing memory; content/tags/confidence folded into it), or "duplicate" (≥0.95 cosine; not stored unless force:true). Use when you learn something worth remembering about the user, project, setup, or workflow; recall with engram_recall, delete with engram_forget.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Optional string tags for categorization and retrieval, e.g. ["backend", "api"]. | |
| force | No | If true, bypass the duplicate check and store even when a ≥0.95-similar memory already exists (creates a near-identical copy — use sparingly). Default false. | |
| entity | No | What this memory is about (e.g., "nginx", "deployment", "coding-style", "project-api"). Helps with retrieval. | |
| content | Yes | The memory to store. Be specific and factual. Good: "User prefers Fastify over Express for Node.js APIs". Bad: "User likes stuff". | |
| category | No | Type of memory. preference=user likes/dislikes, fact=objective truth about their setup, pattern=recurring workflow, decision=choice they made and why, outcome=result of an action | fact |
| namespace | No | Project/scope to store under (default "default"). Use a project name to isolate project-specific memories; "default" for general ones. | default |
| confidence | No | How confident this memory is accurate, 0.0–1.0 (default 0.8). Use 1.0 for facts the user explicitly stated, 0.5–0.7 for inferred preferences. |