Skip to content
NewMinniCode is out now, in Experimental Beta.Get MinniCode→
Minni AI
DemoEvidenceService
Products
Products
  • MinniMemoryMCPFlagship, early accessMemory for your AI agentSplits your agent’s memory into a small always-on part and files that load only when a task needs them.
  • MinniCodeExperimental BetaOpen-LLM optimized, low token coding agentA low token terminal coding agent, optimized for open LLMs. Reads, edits, tests and opens pull requests.
  • MinniTunerExperimental Beta, WindowsHardware optimization agentTunes how your PC uses its CPU, GPU and RAM. One plan you approve, every change undoable.
DocsMinniMemoryMCP docsInstall it, the commands, undoMinniCode docsInstall it, pick a model, the commandsMinniTuner docsThe tiers, Ask Minni, what is sent
See it workDemoThe full tour in one videoHow it worksEach product, step by step
Resources
LearnGuidesFAQnpm package
CompanyContactSupportPrivacyTermsData handlingSecurity

Guides

Where Claude Code keeps its memory

Claude Code has no single memory directory. It reads CLAUDE.md files from four places, the files they import, a rules folder in the project, and an auto memory folder per repository under ~/.claude/projects/<project>/memory/. Here is every path, what it holds, and which ones load on every turn.

Updated 2026-11-07

Every path, in load order#

PathWhat it isLoads
C:\Program Files\ClaudeCode\CLAUDE.md (Windows), /etc/claude-code/CLAUDE.md (Linux), /Library/Application Support/ClaudeCode/CLAUDE.md (macOS)Managed policy, written by an organizationEvery session
~/.claude/CLAUDE.mdYour user instructions, for every projectEvery session
./CLAUDE.md or ./.claude/CLAUDE.mdThe project’s instructions, shared through git. ./AGENTS.md can take its placeEvery session
./CLAUDE.local.mdYour own notes for this project, kept out of gitEvery session
Any file named with @path inside one of the aboveAn import. Up to four hops deepEvery session, with the file that imports it
./.claude/rules/*.mdProject rules, one topic per file, subfolders allowedEvery session; a rule with a paths field only when Claude touches a matching file
<subfolder>/CLAUDE.mdInstructions for one part of the projectWhen Claude works in that subfolder
~/.claude/projects/<project>/memory/MEMORY.mdThe index of auto memory, one line per noteEvery session, the start of the file
~/.claude/projects/<project>/memory/*.mdOne auto memory note per file, written by ClaudeWhen Claude opens one

Source: Anthropic’s memory docs. <project> is derived from the git repository, so every worktree and subfolder of a repo shares one auto memory folder; outside git it is the folder you launched in. autoMemoryDirectory in settings.json moves it, and CLAUDE_CONFIG_DIR moves ~/.claude itself.

Find what loaded in your session#

  1. Run /context all in a session. The list under Memory files is every CLAUDE.md and CLAUDE.local.md that loaded at launch. A subfolder file is not there: it loads later, and prints a Loaded line with its path when it does.
  2. Run /memory to open the memory files for editing, and to see the auto memory toggle.
  3. Open ~/.claude/projects/ and find the folder named after your repository; its memory/ folder is the auto memory.

Auto memory and the session transcripts are separate. Transcripts live beside the memory folder and are deleted after the cleanupPeriodDays setting; memory stays until you delete it.

What MinniMemoryMCP writes beside them#

MinniMemoryMCP reads only the files above that you tell it Claude Code loads; it searches for nothing. When it compiles a memory, it writes in two places:

PathWhat it holds
./.claude/OnDemandMemory/The sections moved out of the always-loaded part, as <parent>__history.md and <parent>__detail.md
./.minnimemory/The backups of your originals, manifest.json, graph.json and a .gitignore that keeps the backups out of git
~/.claude/minnimemory/discovery.jsoninit’s record of where Claude Code loads from, so nothing is asked twice
~/.claude/minnimemory/ (load log, usage log, hook sessions, undo backups)Machine-local records the hooks keep: which memory files loaded, which OnDemandMemory files sessions open, what a forced undo discarded

On a memory folder it sorts in place: AlwaysOnMemory/ and OnDemandMemory/ subfolders, MEMORY.md kept with its link targets updated. undo removes all of it and restores the originals byte for byte. The full list is in the MinniMemoryMCP docs.

install it for Claude Code
$ npm i -g minnimemory
$ minnimemory install

What carries over between sessions and why it costs tokens is in How Claude Code remembers across sessions.

Try MinniMemoryMCP

Free, runs on your computer, and every change can be undone. Two commands install it for Claude Code; the docs cover Codex and the rest.

install it for Claude Code
$ npm i -g minnimemory
$ minnimemory install

More guides

  • How to reduce Claude Code token usage

    Where the tokens go each turn, and eight ways to spend fewer.

    Updated 2026-11-16 · Minni AI

  • Claude Code usage limit reached: what to do, and how to hit it less

    What each limit message means, what to do now, and how to send less every turn.

    Updated 2026-11-16 · Minni AI

  • CLAUDE.md too long: what Claude Code does with it, and how to split it

    What a long CLAUDE.md costs, the real size limits, and four ways to cut it.

    Updated 2026-11-16 · Minni AI

  • Claude Code context window keeps filling up: why it compacts, and what to do

    What fills the window, what compaction keeps, and how to compact less often.

    Updated 2026-11-16 · Minni AI

  • How to reduce Codex token usage

    Where Codex spends tokens, and seven ways to spend fewer.

    Updated 2026-11-16 · Minni AI

  • Codex usage limits: why they drain and how to use fewer tokens

    How the windows work, how to check what is left, and what uses the allowance up.

    Updated 2026-11-11 · Minni AI

  • AGENTS.md too large: what Codex cuts off and how to split it

    The 32 KiB cap, how to see which files load, and five ways back under it.

    Updated 2026-11-11 · Minni AI

  • How to lower a Claude Code or Codex API bill

    What a coding agent bills on an API key, and the levers that move it.

    Updated 2026-11-16 · Minni AI

  • Why Claude Code sessions get expensive

    Every turn re-sends the whole session. What makes that grow.

    Updated 2026-11-05 · Minni AI

  • Claude Code memory: CLAUDE.md vs MinniMemoryMCP

    What belongs in CLAUDE.md, and splitting the rest out by hand or with a tool.

    Updated 2026-11-16 · Minni AI

  • MinniMemoryMCP vs Mem0, Zep, supermemory and Letta

    Four tools add memory to an agent. MinniMemoryMCP cuts what the agent already loads. When each fits.

    Updated 2026-11-16 · Minni AI

  • How Claude Code remembers across sessions

    What carries over between sessions, what does not, and how to keep it small.

    Updated 2026-11-16 · Minni AI

  • How to run a coding agent on free, open models

    What a free key gets you, what a local model can do, and where the tokens go.

    Updated 2026-10-25 · Minni AI

  • Get a free NVIDIA API key for a coding agent

    Where the key comes from, where to keep it, and how to run a coding agent on it.

    Updated 2026-11-07 · Minni AI

  • What a Windows PC optimization agent should and should not touch

    The settings worth changing, the ones that are placebo, and the ones that break things.

    Updated 2026-10-25 · Minni AI

GuidesMinniMemoryMCPHome
© 2026 Minni AI. All rights reserved.