Mnemolith – AI coding memory that goes stale when your code changes
Mnemolith, a new open-source tool, provides shared local memory for AI coding tools like Claude Code and Cursor, ensuring memories stay accurate as code changes.
Formerly known as Aether Cache, Mnemolith (meaning 'memory stone') provides AI coding tools with a shared, local memory that remains accurate as code evolves. The tool automatically retires memories when their associated files change, preventing outdated information from confusing AI models during future sessions.
Unlike traditional AI tools that forget project details between sessions or potentially retain incorrect information, Mnemolith maintains a persistent memory that stays synchronized with code changes. Each memory is linked to specific files through git content hashes, ensuring relevance and accuracy.
Smart Memory Management
The system automatically handles memory contradictions by replacing outdated facts rather than hoarding them. For example, if a memory states 'we use Postgres' but the codebase has been migrated to MySQL, the older memory is retired rather than coexisting with the new information and potentially confusing the AI model.
Memories go stale when the code changes. Each memory is linked to the files it's about, with a snapshot of their git content hash. When docker-compose.yml changes, the memory about it is retired automatically instead of being fed to your AI forever.
Technical Implementation
Mnemolith runs entirely on the user's machine with a custom-built Java database engine that's compatible with Redis but includes additional features specifically designed for memory management. The system uses a HNSW vector index for efficient memory retrieval and maintains an append-only file for crash safety.
The tool integrates with existing project files by syncing memories into managed sections of AGENTS.md and CLAUDE.md, making them visible to teammates who don't use Mnemolith. This ensures shared understanding across development teams while maintaining privacy as all data stays local.
User Experience
Installation is straightforward with a single command that sets up everything needed. The tool automatically detects and connects to supported AI tools like Claude Code, Cursor, and Codex in any git repository. Users can import existing notes from CLAUDE.md or AGENTS.md into the memory system.
The dashboard provides a visual interface for managing memories, showing when files have changed and requiring user confirmation for memories that are still relevant. This transparency helps developers maintain accurate mental models of their codebase while leveraging AI assistance more effectively.
Related
