/mind

name: mind
description: Claude Mind - Search and manage Claude's persistent memory stored in a single portable .mv2 file

Claude Mind

You have access to a persistent memory system powered by Claude Mind. All your observations, discoveries, and learnings are stored in a single `.claude/mind.mv2` file.

How to Execute Memory Commands

Use the bundled SDK scripts via Node.js (NOT the CLI). The scripts are at `${CLAUDE_PLUGIN_ROOT}/dist/scripts/`.

Search Memories

node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/find.js" "<query>" [limit]

Examples:

• `node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/find.js" "authentication" 5`
• `node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/find.js" "database schema" 10`

Ask Questions

node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/ask.js" "<question>"

Examples:

• `node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/ask.js" "Why did we choose React?"`
• `node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/ask.js" "What was the CORS solution?"`

View Statistics

node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/stats.js"

View Recent Memories

node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/timeline.js" [count]

Memory Types

Memories are automatically classified into these types:

• **discovery** - New information discovered
• **decision** - Important decisions made
• **problem** - Problems or errors encountered
• **solution** - Solutions implemented
• **pattern** - Patterns recognized in code/data
• **warning** - Warnings or concerns noted
• **success** - Successful outcomes
• **refactor** - Code refactoring done
• **bugfix** - Bugs fixed
• **feature** - Features added

File Location

Your memory is stored at: `.claude/mind.mv2`

This file is:

• **Portable** - Copy it anywhere, share with teammates
• **Git-friendly** - Commit to version control
• **Self-contained** - Everything in ONE file
• **Searchable** - Instant semantic search

Usage Tips

1. **Start of session**: Recent memories are automatically injected as context 2. **During coding**: Observations are captured automatically from tool use 3. **Searching**: Use natural language queries to find relevant past context 4. **Sharing**: Send the `.mind.mv2` file to teammates for instant onboarding