explaingit

menot-you/n-memory

Analysis updated 2026-05-18

5RustAudience · developerComplexity · 3/5Setup · moderate

TLDR

A local memory tool for AI coding assistants that remembers past decisions and context across sessions. It stores everything in a single local file and refuses to guess when it doesn't have an answer.

Mindmap

mindmap
  root((repo))
    What it does
      Persistent local memory
      Returns evidence with sources
      Abstains when no answer
    Tech stack
      Rust
      SQLite
      MCP protocol
    Use cases
      Remember past decisions
      Recall design choices
      Session summaries
    Audience
      AI coding assistants
      Developers using agents
    Setup
      Shell script or build
      Register as MCP tool
      Local file storage

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Give your AI coding assistant a persistent memory so you don't re-explain project context every session.

USE CASE 2

Store past bug fixes and design decisions with sources so the agent can recall verified information later.

USE CASE 3

View a session summary showing what the memory system knows, what is ready, and what is blocked.

USE CASE 4

Keep all memory data local on your machine with no cloud sync, no server, and no telemetry.

What is it built with?

RustSQLiteMCP

How does it compare?

menot-you/n-memorydhkts1/teamclaude-rselofight/emufight
Stars555
LanguageRustRustRust
Setup difficultymoderateeasyhard
Complexity3/52/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires building from source with Rust and registering the binary as an MCP tool with your AI agent.

No license information was provided in the explanation, so the specific terms of use are unknown.

In plain English

nMEMORY is a memory tool designed for AI coding assistants. The core problem it addresses is that AI agents typically start each session with no recollection of prior decisions, design choices, or past bugs, forcing the developer to re-explain context every time. This project, written in Rust, gives an agent a persistent, local memory store that it can consult, with a single strict rule: when the store does not have an answer, it says so plainly rather than guessing. The tool is built around the idea that a memory which returns a plausible-sounding but unverified answer is worse than no memory at all. When an agent stores information, it must include the origin and a reference point for that data. Any memory entry lacking a source is rejected. When an agent later retrieves information, the system returns one of three outcomes. It either provides the matching evidence with its source and freshness attached, reports that matches were found but excluded (for example, if the information was superseded), or it abstains entirely and states it has nothing relevant. The system is designed to operate entirely on your local machine. It uses a single SQLite file to store all data, with no server, no account, and no background processes running. The binary is compiled without a networking stack, meaning it makes zero socket connections and sends no telemetry anywhere. If you want to move your memory file to another machine, you must do it yourself using an explicit sync command, which delegates the file copy to a separate process. You install it by running a shell script or building it from source with Rust. Once installed, you register it with your AI agent as an MCP tool. The agent then has access to 21 different tools for storing, retrieving, and managing memory. Key operations include capturing new memories with their sources, recalling past information as evidence, and viewing a session summary of what the system knows, what is ready, and what is blocked. Everything the memory returns is labeled as advisory data, not as an instruction, so the stored text cannot hijack the agent's behavior. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
I want to set up nMEMORY as an MCP tool for my AI coding assistant. Walk me through installing it from source with Rust and registering it so my agent can start storing and retrieving memories.
Prompt 2
Help me configure my AI agent to use nMEMORY's 21 tools for capturing memories with sources, recalling past evidence, and viewing session summaries. What are the key operations I should know?
Prompt 3
I have nMEMORY installed and want to move my memory file to another machine. Show me how to use the sync command and what that process does.
Prompt 4
My AI coding assistant keeps forgetting decisions we made in previous sessions. How do I integrate nMEMORY so it can store and recall past context with verified sources?
Prompt 5
Explain how nMEMORY's three retrieval outcomes work and how I should handle each case when my agent queries the memory store for past information.

Frequently asked questions

What is n-memory?

A local memory tool for AI coding assistants that remembers past decisions and context across sessions. It stores everything in a single local file and refuses to guess when it doesn't have an answer.

What language is n-memory written in?

Mainly Rust. The stack also includes Rust, SQLite, MCP.

What license does n-memory use?

No license information was provided in the explanation, so the specific terms of use are unknown.

How hard is n-memory to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is n-memory for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.