This project provides Claude Code with persistent conversational memory via a single, portable `.mv2` file, eliminating the need for external databases. It targets developers seeking to retain context, decisions, and solutions across sessions, offering a fast, private, and version-controllable solution.

How It Works

Upon installation, Claude's interactions, decisions, and bug fixes are stored locally in a `.claude/mind.mv2` file within the project directory. This file acts as a self-contained "brain," auto-injected at session start and searchable anytime. The core is a native Rust engine, enabling sub-millisecond operations and efficient searching of thousands of memories, ensuring privacy and portability without cloud dependencies or API keys.

Quick Start & Requirements

• Primary install: In Claude Code, run /plugin add marketplace memvid/claude-brain. Enable the plugin via the UI and restart. A one-time global Git configuration (git config --global url."https://github.com/".insteadOf "git@github.com:") may be needed if using SSH URLs.
• Prerequisites: Claude Code environment. An optional CLI tool (memvid-cli) can be installed globally via npm install -g memvid-cli.
• Resource Footprint: The .mv2 file is approximately 70KB when empty, growing by ~1KB per memory, and is estimated to stay under 5MB even after a year of use.
• Links: Full Demo

Highlighted Details

• Single-File Memory: The .mv2 file is version-controllable (e.g., git commit), transferable (scp), and shareable, simplifying collaboration and history tracking.
• Performance: Native Rust core provides sub-millisecond operations, capable of searching over 10,000 memories in under 1ms.
• Privacy: All memory data is stored 100% locally and never leaves the user's machine.
• Underlying Engine: Built upon the memvid single-file memory engine.

Maintenance & Community

The project is hosted on GitHub, with a link to star the repository provided. No specific community channels (like Discord or Slack) or details on maintainers/sponsors are listed in the README.

Licensing & Compatibility

The project is released under the MIT License, which is permissive for commercial use and integration into closed-source projects.

Limitations & Caveats

This project functions as a plugin within the Claude Code environment. Memory is reset by manually deleting the `.mv2` file. The core functionality relies on the `memvid` engine.