# Memory

Claude Mind - Search and manage Claude's persistent memory stored in a single portable...

- Repository: https://github.com/memvid/claude-brain (582 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-01-19
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add memvid/claude-brain --skill memory -g -a claude-code -y`
Codex: `npx skills add memvid/claude-brain --skill memory -g -a codex -y`
Cursor: `npx skills add memvid/claude-brain --skill memory -g -a cursor -y`
Gemini CLI: `npx skills add memvid/claude-brain --skill memory -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add memvid/claude-brain`

## Description

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

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

The rest: https://github.com/memvid/claude-brain/blob/HEAD/skills/memory/SKILL.md
