mind
Persistent, Git-friendly memory for Claude. Automatically store and retrieve project decisions, bug fixes, and coding patterns in a local .mv2 file.
Introduction
Claude Mind is a local-first persistent memory engine designed for developers using Claude Code. It overcomes the limitation of finite context windows by providing a dedicated memory storage system that maintains continuity across different coding sessions. By storing observations, architectural decisions, and technical discoveries into a single portable .mv2 file within the .claude directory, Claude can recall past debugging insights, previous refactoring rationales, and project-specific patterns, effectively giving the AI a long-term memory of your repository's history.
The tool is specifically built for professional software engineering workflows where context loss typically hinders productivity. It is ideal for teams or solo developers who want to document why specific libraries were chosen, how complex bugs were resolved, or how to handle specific edge cases in a codebase. Because the memory is stored in a simple file, it is natively compatible with version control systems like Git, allowing developers to share their 'AI's brain' with teammates to streamline onboarding and knowledge transfer.
-
Automatically captures and classifies memories into types like discovery, decision, problem, solution, pattern, warning, success, refactor, bugfix, and feature.
-
Provides a robust CLI and Node.js SDK interface for querying past context, viewing memory statistics, and examining recent timelines.
-
Implemented with a high-performance native Rust core, enabling semantic search across thousands of entries in under one millisecond.
-
Fully local operation ensures that sensitive project information remains on your machine and is never sent to external servers or third-party cloud databases.
-
Use the search feature to find exact past solutions, such as 'Why did we choose JWT for auth?' or 'What was the fix for the CORS error from last week?'
-
The system automatically injects recent memory fragments at the start of every session to ensure Claude maintains awareness of recent progress.
-
Memory files can be safely committed to version control, making them a transparent, queryable log of project evolution.
-
If a memory file becomes corrupted or incompatible, the system includes automated recovery procedures to move the file to a backup and instantiate a fresh state.
-
Storage remains extremely lightweight, with an empty file at ~70KB and a growth rate of approximately 1KB per stored memory entry, ensuring long-term scalability without performance degradation.
Repository Stats
- Stars
- 486
- Forks
- 47
- Open Issues
- 7
- Language
- TypeScript
- Default Branch
- main
- Sync Status
- Idle
- Last Synced
- May 3, 2026, 07:34 PM