# Reduce your coding agent’s token usage with MinniMemoryMCP. > Source: https://minniai.com/ (canonical HTML page) Now available in Claude Code MinniMemoryMCP splits your agent’s memory into a small core that loads every turn and files that load only when a task needs them. Measured in Claude Code: **27.4% cheaper sessions,** no lines lost. [Get MinniMemoryMCP](https://minniai.com/minnimemorymcp) Watch the demo `$ npx -y minnimemory install` Your memory AGENTS.md, MEMORY.md All of it re-read every turn AlwaysOnMemory every turn 6,699 tokens OnDemandMemory when a task asks 5,812 tokens, not re-read 12,511 → 6,699 -46.5% tokens re-read every turn, before and after, test memory. Counted with MinniMemoryMCP 1.2.1, 10 October 2026. ## Watch Minni AI at work. Our research and four tools in one video: MinniMemoryMCP, MinniCode, MinniTuner, and MinniMemoryAgent, a memory upkeep agent that is not public yet. Every number on screen comes from a real run of our tools. ## How we measured **27.4% cheaper Claude Code sessions.** Five results, measured, across MinniMemoryMCP and MinniCode. -27.4% the cost of the run, the same 81 answers before and after Before 3,574,009 After -11.0% -37.4% 3,019,536 - **Cache reads** 2,931,482 to 2,609,556 - **Cache writes** 626,130 to 391,988 - **Output** 16,181 to 17,752, +9.7% Cost falls further than tokens: the saving is mostly in cache writes, the most expensive input, while cache reads cost a tenth as much. 3,574,009 → 3,019,536 tokens $2.31 → $1.68 for the run 72 of 81 correct after, 74 before Re-read every turn -46.5% Each column is one turn 12,511 to 6,699 tokens, test memory Lines lost 0 One square per file 16 of 16 files kept every line, undo restores byte for byte Tokens per answer -58.1% **Without rules** **With rules** 1,006 to 422 tokens, 240 test answers MinniCode cache writes -36% Claude Code 8,273 MinniCode 5,286 5,286 tokens a warm session against 8,273 for Claude Code, same tasks **How we measured** #### Over 3.5 million tokens of measured work After many rounds of testing and tweaking our interface, this is our final run. We gave Claude Sonnet 5.5 the same work in Claude Code, three sessions a side and 81 answers in all: once with the test memory as it was and once after MinniMemoryMCP sorted it. The run used 3,574,009 tokens before and 3,019,536 after, 15.5% fewer, and cost $2.31 before and $1.68 after, 27.4% less. A blind grader marked 74 of 81 answers correct before and 72 of 81 after. MinniMemoryMCP 1.1.0, measured 6 October 2026 #### Less memory loaded on every turn Our full-size test memory went from 12,511 tokens to 6,699 tokens loaded on every turn. The rest moves into files the agent opens only when a task needs them. No lines are lost. Counted with MinniMemoryMCP 1.2.1 on a full-size test memory, 10 October 2026 #### MinniCode writes less to the cache than Claude Code On the same coding tasks, a warm MinniCode session wrote 5,286 tokens to the model's cache against 8,273 for Claude Code, 36% less. Three sessions each on Claude Sonnet, after one uncounted warm-up, every task checked correct. MinniCode on the claude provider, measured 21 October 2026 #### Every line kept, every file restored We compiled the same 16-file test memory and the example file that ships with the package. Every line landed somewhere word for word, and undo put every file back byte for byte. MinniMemoryMCP 1.2.1, measured 9 October 2026 #### Shorter answers with our answer-style rules We asked an AI agent the same questions with and without the rules, 240 answers in all. With the rules, answers used 58.1% fewer tokens. Measured 5 September 2026 #### Methods Session cost: the tokens of every call, priced at Anthropic's published API rates, with the cache reads and writes each call made. Cost falls further than tokens because the saving is mostly in cache writes, the most expensive input, while cache reads, most of the tokens, cost a tenth as much. The grader saw each pair of answers blind, in both orders, and a verdict counted only when both orders agreed. Memory counts: the token counter built into MinniMemoryMCP 1.2.1, run on a full-size test memory of 16 files loaded every turn. Anyone with the package and the same files gets the same numbers. The 58.1%: the same questions answered with and without the rules, counting the tokens in each answer. #### Every figure on this site [The evidence page](https://minniai.com/evidence) lists each number the site quotes with what it counts, the method, the date and the build. #### Read the run line by line [Why Claude Code sessions get expensive](https://minniai.com/learn/why-claude-code-sessions-get-expensive) walks through this run's token table and what moved. ## The MinniMemory Interface: rules for a smaller agent memory. Our research, written down: how an agent’s memory is split, what it reads every turn, and the rules that keep its answers short. Every result above comes from it. You can apply it two ways today. **12,511** **tokens in all** **6,699 tokens** **AlwaysOnMemory** loads every turn **5,812 tokens** **OnDemandMemory** loads when a task asks **12,511 tokens** the whole memory **6,699 tokens** AlwaysOnMemory, loads every turn **5,812 tokens** OnDemandMemory, loads when a task asks Do it yourself ### MinniMemoryMCP [Get MinniMemoryMCP](https://minniai.com/minnimemorymcp) $ npx -y minnimemory install - `init`maps the memory, previews the split - `apply`makes the split - `undo`restores the originals - `doctor`re-checks it later Done with you ### We apply it to your agent - 01 **Measure** what your agent is handed each turn - 02 **Apply** the interface to its memory and instructions - 03 **Report** tokens saved against answer quality ## Three tools, one rule. You see every change and approve it. Pick a tool and watch it work. ### MinniMemoryMCP An MCP server that shrinks what Claude Code loads every turn - Less for Claude Code to re-read every turn - Nothing in your memory is lost - Plain Markdown files you own `$ npx -y minnimemory install` [Get MinniMemoryMCP](https://minniai.com/minnimemorymcp) [Read the docs](https://minniai.com/minnimemorymcp/docs)[Read the guide](https://minniai.com/learn/claude-code-memory-claude-md-vs-minnimemorymcp) ### MinniCode An open-LLM optimized low token terminal coding agent - Free to run - You approve every step - Optimized for open LLMs `$ irm https://minniai.com/install | iex` [Get MinniCode](https://minniai.com/minnicode) [Read the docs](https://minniai.com/minnicode/docs)[Read the guide](https://minniai.com/learn/run-a-coding-agent-on-free-open-models) ### MinniTuner The PC and hardware optimization agent for Windows gamers - Reads your PC, not a generic list - One plan, one approval - Measured, not promised - **Free:** The checkup, chat with the agent, Basic plans and undo. Free forever. - **MinniTuner Pro:** $19.99 one time, 3 PCs, lifetime updates. The Advanced FPS tier, custom fixes, diagnostics and the before-and-after measurement. [Download MinniTuner](https://minniai.com/minnituner) [Read the guide](https://minniai.com/learn/what-a-pc-optimization-agent-should-touch) ## Help keep the research running. MinniMemoryMCP and MinniCode are free, and so is BasicTuner. We pay for the test runs, the AI calls and the hosting behind them. If our tools saved you time or tokens, you can back the work. [Buy us a coffee](https://buymeacoffee.com/minnilabs) Payments go through Buy Me a Coffee. Support is a gift: it does not buy a product or a license, and it is not tax deductible. ## Frequently asked questions **01 Do you see my code or my memory files?** MinniMemoryMCP never does. It runs entirely on your computer, sends nothing anywhere, needs no account or API key, and has no AI model inside it. MinniCode sends each request straight from your computer to the provider whose key you gave it (NVIDIA, OpenRouter or Claude) or to a model on your own computer, so our servers never see your code. The chat window on this page is answered by an outside AI provider, and we don't store those messages either. **02 Why not just edit the file myself?** You can, and for a short file you should. It gets harder as the file grows: you have to decide which lines your agent needs on every turn, move the rest into separate files without dropping anything, and leave a pointer so the agent knows when to open each one. MinniMemoryMCP does that sorting for you, backs up your originals first, and can re-sort after you edit the file again. **03 What if it wrecks my memory files?** It backs up your originals before it writes anything, and one command, undo, puts them back exactly as they were. Inside Claude Code the server itself never writes: apply and undo return the command to run and the list of files it touches, and your agent runs that command through your own approval prompt, so you see every change. Run from the terminal, apply writes the files itself, after the backup. **04 What does it cost?** MinniMemoryMCP is free during early access. MinniCode is free. MinniTuner is in open beta: the free tier (checkup, chat, Basic plans, undo) is free forever, and MinniTuner Pro is $19.99 one time for 3 PCs with lifetime updates. **05 Does MinniCode need a paid API key?** No. MinniCode runs on free models from NVIDIA or OpenRouter with your own free key, on your Claude subscription through Claude Code, or on a model on your own computer through Ollama or LM Studio. It asks for the key the first time you run it, and requests go straight from your computer to the provider. **06 Can MinniTuner change something I cannot undo?** It tells you first. Before a plan runs it saves a restore point, then applies each step with its own undo record, and Undo replays that log. Anything that cannot be undone says so before you approve it. Windows Defender stays on, and anti-cheat and game launcher services are never turned off. **07 Who makes Minni?** Minni was founded by Hamzah Muhammad, a former software engineer at Amazon, with two co-founders: a second engineer also from Amazon, and Reynardo, formerly at Microsoft. Four engineers build it in all. We ran into the same problem in our own work: coding agents re-reading their whole memory every turn, and token bills growing with it. Minni is what we built to fix that, a smaller always-loaded memory with the rest loaded only when needed, and we publish a number only after we have measured it. ## Talk to us before it gets expensive. Send us what your agent loads each turn. We apply the interface and report tokens saved against answer quality. Minni AI · agent interface and memory research Minni is built by four engineers, two of them ex-Amazon, who got tired of watching coding agents re-read their whole memory every turn. Chat messages are answered by a third-party model provider; Minni does not store them. Contact requests are emailed to us and kept only in that mailbox. The [privacy policy](https://minniai.com/privacy) has the detail. © 2026 Minni AI. All rights reserved. minni --- Index for agents: https://minniai.com/llms.txt. Doing a task: https://minniai.com/agents.md