Skill502 repo starsupdated 4mo ago

memory

Claude Mind provides persistent memory storage and retrieval for Claude across sessions using a portable .mv2 file. Use it to search past observations and decisions via natural language queries, ask contextual questions about previous work, view memory statistics and timelines, and share project context with teammates by distributing the single memory file. The system automatically captures discoveries, decisions, problems, solutions, and other memory types during coding work.

View source Repository: claude-brain

Install in Claude Code

Copy

git clone --depth 1 https://github.com/memvid/claude-brain /tmp/memory && cp -r /tmp/memory/skills/memory ~/.claude/skills/memory

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# 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
```bash
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
```bash
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
```bash
node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/stats.js"
```

### View Recent Memories
```bash
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