Claude Cortex — Memory System
You have access to a persistent memory system via MCP tools (remember, recall, get_context, forget).
MUST use remember immediately when any of these occur:
- A decision is made (architecture, library choice, approach)
- A bug is fixed (capture root cause + solution)
- Something new is learned about the codebase
- User states a preference
- A significant feature is completed
Do not wait until the end of the session. Call remember right after the event happens.
Tools
| Tool |
Purpose |
remember |
Store a memory with title, content, category, importance |
recall |
Search memories by query, category, tags |
get_context |
Load relevant project context (architecture, patterns, preferences) |
forget |
Delete memories by ID or query |
start_session |
Begin a session and load context |
end_session |
End session and trigger consolidation |
memory_stats |
View memory statistics |
graph_query |
Traverse the knowledge graph |
graph_entities |
List entities in the knowledge graph |
detect_contradictions |
Find conflicting memories |
When to Use remember
- After making a decision: "Decided to use PostgreSQL for better JSON support"
- After fixing a bug: "Auth bug caused by expired JWT tokens"
- After learning something: "SQLite FTS5 requires escaping hyphens"
- For architecture choices: "Using microservices pattern with API gateway"
- For user preferences: "User prefers TypeScript strict mode"
Best Practices
- Call
remember immediately when something important happens
- Include context: what, why, and any relevant code/file references
- Use clear titles that summarize the key point
- Tag with relevant categories (architecture, error, learning, preference)
What Gets Auto-Extracted by Hooks
The PreCompact and SessionEnd hooks automatically extract high-salience content:
- Decisions: "decided to...", "going with...", "chose...", "using..."
- Error fixes: "fixed by...", "the solution was...", "root cause..."
- Learnings: "learned that...", "discovered...", "turns out..."
- Architecture: "created...", "implemented...", "refactored..."
- Preferences: "always...", "never...", "prefer to..."
- Notes: "important:", "remember:", "key point..."
Don't rely solely on auto-extraction. Use remember proactively for important events.
Source: mkdelta221/claude-cortex — distributed by TomeVault.
1---2name: memory-63description: Persistent memory system — use proactively to remember decisions, fixes, learnings, and preferences across sessions. Invoke when you need to save or recall important context. Use when this capability is needed.4---56# Claude Cortex — Memory System78You have access to a persistent memory system via MCP tools (`remember`, `recall`, `get_context`, `forget`).910**MUST use `remember` immediately when any of these occur:**11- A decision is made (architecture, library choice, approach)12- A bug is fixed (capture root cause + solution)13- Something new is learned about the codebase14- User states a preference15- A significant feature is completed1617Do not wait until the end of the session. Call `remember` right after the event happens.1819## Tools2021| Tool | Purpose |22|------|---------|23| `remember` | Store a memory with title, content, category, importance |24| `recall` | Search memories by query, category, tags |25| `get_context` | Load relevant project context (architecture, patterns, preferences) |26| `forget` | Delete memories by ID or query |27| `start_session` | Begin a session and load context |28| `end_session` | End session and trigger consolidation |29| `memory_stats` | View memory statistics |30| `graph_query` | Traverse the knowledge graph |31| `graph_entities` | List entities in the knowledge graph |32| `detect_contradictions` | Find conflicting memories |3334## When to Use `remember`3536- **After making a decision**: "Decided to use PostgreSQL for better JSON support"37- **After fixing a bug**: "Auth bug caused by expired JWT tokens"38- **After learning something**: "SQLite FTS5 requires escaping hyphens"39- **For architecture choices**: "Using microservices pattern with API gateway"40- **For user preferences**: "User prefers TypeScript strict mode"4142## Best Practices43441. Call `remember` immediately when something important happens452. Include context: what, why, and any relevant code/file references463. Use clear titles that summarize the key point474. Tag with relevant categories (architecture, error, learning, preference)4849## What Gets Auto-Extracted by Hooks5051The PreCompact and SessionEnd hooks automatically extract high-salience content:52- **Decisions**: "decided to...", "going with...", "chose...", "using..."53- **Error fixes**: "fixed by...", "the solution was...", "root cause..."54- **Learnings**: "learned that...", "discovered...", "turns out..."55- **Architecture**: "created...", "implemented...", "refactored..."56- **Preferences**: "always...", "never...", "prefer to..."57- **Notes**: "important:", "remember:", "key point..."5859Don't rely solely on auto-extraction. Use `remember` proactively for important events.6061---62> Source: [mkdelta221/claude-cortex](https://github.com/mkdelta221/claude-cortex) — distributed by [TomeVault](https://tomevault.io).63<!-- tomevault:4.0:skill_md:2026-06-21 -->