# memory

Adopt this skill: https://proskills.md/skills/other/memvid-claude-brain-skills-memory

Page: https://proskills.md/skills/other/memvid-claude-brain-skills-memory
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: skills/memory/SKILL.md
size: 2243
upstream: https://github.com/memvid/claude-brain/blob/main/skills/memory/SKILL.md

````text
---
name: memory
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
```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
````

## File: README.md
upstream: https://github.com/memvid/claude-brain/blob/main/README.md

````text
<div align="center">

<img src="logo.png" alt="Claude Brain" width="320" />

### Give Claude Code photographic memory.

[![GitHub stars](https://img.shields.io/github/stars/memvid/claude-brain?style=social)](https://github.com/memvid/claude-brain)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

<br />

https://github.com/user-attachments/assets/b57cb3db-576b-4c1f-af92-95796ba3fb5b

<br />

**[Install in 30 seconds](#installation)** · [How it Works](#how-it-works) · [Commands](#commands) · [Full Demo](https://youtu.be/uRT0CMdK0yg)

</div>

<br />

## The Problem

```
You: "Remember that auth bug we fixed?"
Claude: "I don't have memory of previous conversations."
You: "We spent 3 hours on it yesterday"
Claude: "I'd be happy to help debug from scratch!"
```

**200K context window. Zero memory between sessions.**

You're paying for a goldfish with a PhD.

<br />

## The Fix

```
You: "What did we decide about auth?"
Claude: "We chose JWT over sessions for your microservices.
        The refresh token issue - here's exactly what we fixed..."
```

One file. Claude remembers everything.

<br />

## Installation

```bash
# One-time setup (if you haven't used GitHub plugins before)
git config --global url."https://github.com/".insteadOf "git@github.com:"
```

```bash
# In Claude Code
/plugin add marketplace memvid/claude-brain
```

Then: `/plugins` → Installed → **mind** Enable Plugin → Restart.

Done.

<br />

## How it Works

After install, Claude's memory lives in one file:

```
your-project/
└── .claude/
    └── mind.mv2   # Claude's brain. That's it.
```

No database. No cloud. No API keys.

**What gets captured:**
- Session context, decisions, bugs, solutions
- Auto-injected at session start
- Searchable anytime

**Why one file?**
- `git commit` → version control Claude's brain
- `scp` → transfer anywhere
- Send to teammate → instant onboarding

<br />

## Commands

**In Claude Code:**
```bash
/mind stats                       # memory statistics
/mind search "authentication"     # find past context
/mind ask "why did we choose X?"  # ask your memory
/mind recent                      # what happened lately
```

Or just ask naturally: *"mind stats"*, *"search my memory for auth bugs"*, etc.

<br />

## CLI (Optional)

For power users who want direct access to their memory file:

```bash
npm install -g memvid-cli
```

```bash
memvid stats .claude/mind.mv2           # view memory stats
memvid find .claude/mind.mv2 "auth"     # search memories
memvid ask .claude/mind.mv2 "why JWT?"  # ask questions
memvid timeline .claude/mind.mv2        # view timeline
```

[Full CLI reference →](https://docs.memvid.com/cli/cheat-sheet)

<br />

## FAQ

<details>
<summary><b>How big is the file?</b></summary>

Empty: ~70KB. Grows ~1KB per memory. A year of use stays under 5MB.

</details>

<details>
<summary><b>Is it private?</b></summary>

100% local. Nothing leaves your machine. Ever.

</details>

<details>
<summary><b>How fast?</b></summary>

Sub-millisecond. Native Rust core. Searches 10K+ memories in <1ms.

</details>

<details>
<summary><b>Reset memory?</b></summary>

`rm .claude/mind.mv2`

</details>

<br />

---

<div align="center">

Built on **[memvid](https://github.com/memvid/memvid)** - the single-file memory engine

<br />

**If this saved you time, [star the repo](https://github.com/memvid/claude-brain)**

<br />

*Send me your `.mv2` file and I'll tell you what's wrong with your code. No context needed - I already know everything.*

</div>
````
