memory
AI context that persists across sessions
Stop repeating yourself. The memory tool stores your preferences, decisions, and project context so AI assistants remember what matters to you.
Problems This Solves
"AI keeps forgetting my preferences"
Every new chat starts fresh. You have to re-explain that you prefer early returns, hate mocks, and want TypeScript strict mode.
"Context gets lost mid-project"
Long projects hit context limits. AI forgets decisions made hours ago and suggests approaches you already rejected.
"Can't resume where I left off"
Close your IDE, come back tomorrow, and you're starting from scratch. No continuity between sessions.
"Team knowledge doesn't stick"
Each developer teaches AI the same project conventions. No shared understanding of architecture decisions or coding standards.
Three Types of Memory
Inspired by cognitive science research (CoALA framework), memories are automatically classified for optimal retrieval.
Episodic Memory
What happened and when. Time-ordered experiences like sessions, debugging logs, and assessment results.
Examples:
- Session on Nov 15: Fixed authentication bug in /api/login
- Code assessment: 3 security issues found in payment.ts
- Debugging session: Memory leak traced to event listeners
Semantic Memory
Facts and knowledge. Conceptual information like preferences, architecture decisions, and domain knowledge.
Examples:
- User prefers early returns over nested conditionals
- Project uses Drizzle ORM with PostgreSQL
- ADR-012: Chose JWT over session cookies for auth
Procedural Memory
How to do things. Recipes, workflows, and step-by-step processes that can be reused.
Examples:
- Deploy to production: build, test, docker push, k8s apply
- Setup new microservice: scaffold, env vars, health check, CI
- Stripe integration: API key, webhook secret, test mode first
Key Actions
session_start
EssentialRun this first in every session. Loads your previous context, preferences, and recent work.
memory({ action: 'session_start' })search
High UseFind relevant memories before asking the user. Semantic search across all memory types.
memory({ action: 'search', query: 'authentication approach' })add
Store new knowledge. Memory type is auto-detected or can be specified.
memory({ action: 'add', text: 'User prefers Zod for validation' })session_end
Save a summary when done. Captures what was accomplished for the next session.
memory({ action: 'session_end', summary: 'Completed auth refactor' })Memory Scopes
Control who can access memories. Personal stays private; shared scopes enable team knowledge.
Personal
Your private preferences, habits, and personal workflow notes. Only you can see these.
Repo
Project-specific decisions, architecture notes, and codebase conventions. Shared with project collaborators.
Team
Team coding standards, shared patterns, and cross-project knowledge. Available to all team members.
Org
Organization-wide policies, security requirements, and enterprise standards. Accessible company-wide.
Ready to stop repeating yourself?
Connect your IDE and start building persistent context today.