2.7 KiB
2.7 KiB
Engram — Persistent Memory
You have Engram memory tools via MCP. Use them proactively — do not wait to be asked.
Session Start
- ALWAYS call
engram_briefingat the start of every session to load context from past sessions.
What to Remember (call engram_remember immediately)
Store ANY of these the moment you encounter them — do not batch, do not wait:
From the user:
- Preferences, opinions, personal facts, decisions, corrections
- "I prefer X", "we decided Y", "actually it's Z"
From your own work:
- When you read a file and synthesize useful knowledge (style guides, architecture patterns, workflow rules) — store the synthesis
- When you figure out HOW the user works (communication style, review habits, tool preferences) — store the observation
- When you discover project conventions, naming patterns, or implicit rules — store them
- When you build something and learn what works vs what doesn't — store the lesson
The rule: If this knowledge would be useful in a future session, store it NOW. Don't assume you'll remember — you won't.
Team Vault
- When connected to a hosted vault, memories are shared with your team by default
- Use
engram_private_sessionif the user wants a confidential session (nothing leaves the local machine) - Use
engram_inviteto add a teammate when asked ("add Brian to engram", "invite tyler@company.com") - Recall always searches both local + shared vaults, so you see everything
Asking Questions
- When you need to ANSWER a question from memory: call
engram_ask— it returns a synthesized answer with confidence, not raw memories - When you need raw memory objects for processing: call
engram_recall - Prefer
engram_askfor user-facing answers,engram_recallfor your own analysis
Alerts
- Periodically call
engram_alertsto check for pending commitments, stale follow-ups, and contradictions - Alerts are included in
engram_briefingautomatically, but call separately if you need a quick check
Auditing External Memory
- If you maintain a CLAUDE.md, MEMORY.md, or similar file: periodically call
engram_auditwith its contents - It will flag any claims that are outdated or contradicted by newer vault data
Before Compacting / Session End
- Before context compaction or ending a session, call
engram_checkpointwith a summary of:- Decisions made and their reasoning
- Facts learned or corrected (especially things that changed from what you previously knew)
- Commitments and next steps
- Current project state
- This extracts durable memories from your context window before it is lost
- Your context window is the most accurate source of truth you have — and the most volatile. Save it.