Memory You Own.
Your agent's memory, in plain files that move between platforms and answer to you. Free on GitHub.
The folder is the memory. Move the folder, and the memory moves with you.
Point Your Agent At The Repo.
There is no installer to download and nothing to sign up for. You give your agent the instruction below, and it follows the repo's install guide, keeps any memory and instructions you already have, and runs a self-check before it reports back.
Install BIMRI in this project from https://github.com/EvolutionUnleashed/bimri. Follow INSTALL.md, preserve my existing instructions and memory, and run the self-check.
WORKS WITH · Claude, Codex, and other local agents
RUNTIME · one Python 3.8+ script and ordinary local files, nothing else to install
DATA · stays in the folder on your machine; there is no server and no account
AI Memory Today Has A Landlord.
An agent that forgets starts every morning as a stranger, and the tools that do remember hold the memory on their terms. Three problems sit underneath, and most people have learned to live with them.
You cannot read it
Try opening your AI's memory of your business. There is no file to read and no way to fix what it has wrong. You find out what it remembers when it acts on it.
You cannot take it with you
Switch tools and the accumulated understanding of your business stays behind. Memory you cannot move is a lease, and the rent is your switching cost.
Two agents will trample it
Run two agents against the same notes and they will eventually write over each other. Neither of them notices.
Your Agent's Memory. On Your Machine. Yours.
BIMRI is a memory system that lives in a folder on your machine, run by an engine that keeps it safe: every memory carries where it came from and how much to trust it, and when two memories genuinely conflict, the engine stops and asks you. Copy the folder and everything your agent knows arrives with you on a new machine or an entirely different AI platform. The model is the replaceable part; the memory is what actually knows your business, and it gets more valuable every week your agent runs.
What One Memory Actually Looks Like.
Every entry carries the fact, where it came from, and how much weight to give it. This is the real format.
[R000012-E004] [K:offer.spring-promotion] [fact] [T:confirmed] [SRC:user] The spring promotion runs to 30 April at 20% off the annual plan. The owner set the end date on the 2 April call and it does not extend. Quote it only with the end date attached.
[K:...] a stable key, so a newer memory on the same subject replaces this one instead of piling up beside it
[SRC:user] where it came from: the owner said it, an agent inferred it, or outside material suggested it
[T:confirmed] how much to trust it, so agents weigh what they read instead of swallowing it whole
What Makes BIMRI Different.
Portable between platforms
The memory is a folder, and a folder moves. It arrives whole on a new machine, under a different agent, or on another AI platform entirely.
Readable by you
Plain Markdown you can open in any editor. Read exactly what your agent believes, then fix it if it is wrong.
Safe with many agents
Multiple agents can run at once, each in its own isolated lane. Independent memories merge automatically, and nothing gets trampled.
Governed by you
When two memories genuinely conflict, BIMRI stops and asks a human instead of guessing. You stay the referee.
Provenance built in
Every memory carries where it came from and how much to trust it. Six weeks later you can still trace why the agent believes what it believes.
Yours forever
Free and open source, with nothing to cancel and nobody able to take the memory away from you.
Several Agents. One Memory. No Mess.
BIMRI lets several agents work from the same memory folder at the same time without writing over each other. We know because it happens in our own business: one evening a second agent showed up for work while the first was mid-job. It saw the folder was busy, waited its turn, and noted why. Nothing was lost, nothing was done twice, and the whole event is on the record.
Read that journal entryBIMRI Is The Memory Layer Of Our Compounding Intelligence Engine.
Alongside it sit continuity, feedback learning, and a results ledger. BIMRI is the piece we opened to the world.
The Straight Answers.
What is BIMRI?
Brief Interaction Memory and Retrieval Intelligence: a free, open source memory system for AI agents. It keeps everything your agent knows in plain files on your machine, so the memory is readable, portable, and yours. MIT licensed, on GitHub.
How do I install it?
Your agent installs it for you. Point it at the repo with the instruction above, and it follows the install guide, keeps any memory you already have, and runs a self-check before reporting back.
What does it work with?
Claude, Codex, and other local agents. Any agent that can run a Python script and follow written instructions can share the same memory, and that is the point: the memory belongs to the project rather than to any one tool.
How is this different from the memory my AI app already has?
The memory built into an AI app lives inside that app: you cannot open it, move it, or take it with you when you leave. BIMRI keeps the memory in files you can read, on a machine you control, in a format any local agent can use.
Does anything leave my machine?
No. The memory is ordinary files in your project folder, with no server or account behind it. Nothing is sent anywhere, and deleting the folder removes every trace.
Can several agents share one memory?
Yes, on one machine at a time. Each agent works in its own lane with its own log, independent changes merge on their own, and a genuine conflict stops and comes to you instead of being guessed at.
What does it cost?
Nothing. BIMRI is MIT licensed and free for personal and commercial use. There is no paid tier behind it and nothing to cancel, because the files are already yours.
Under The Hood.
BIMRI is built for many agents sharing one memory. The working file your agent reads is a generated, bounded view backed by immutable revisions: fast to load, safe to trust, fully recoverable.
ISOLATED RUNS
Several agents can work at once, each in its own lane with its own run handle and log. They stay out of each other's way by design.
ATOMIC WRITES + CRASH RECOVERY
Every change lands whole, under an OS file lock, with crash-safe intents behind it. Pull the plug mid-write and the memory recovers clean.
AUTOMATIC MERGE
Independent memories from different agents combine on their own. The merge is deliberate, keyed, and safe to repeat.
HUMAN ESCALATION
When two memories genuinely disagree, BIMRI stops and brings the conflict to you. You stay the referee of what your agents believe.
PROVENANCE + TRUST LEVELS
Every memory carries where it came from and how much weight to give it, so agents can weigh what they read instead of swallowing it whole.
TEST SUITE IN PUBLIC CI
255 tests cover concurrency, crash recovery, migration, integrity and safety, running in public CI on Linux and Windows under Python 3.8 and 3.12 on every change.
DESIGN BOUNDARY · STATED PLAINLY
BIMRI coordinates agents on one machine and one local filesystem at a time. The memory folder is fully portable between machines and agents, and should be moved or copied while no agent is writing to it. That boundary is deliberate: it keeps the whole system inspectable, dependency-free, and yours.
v5.1.1 · MIT · open source, on the record · verified 3 Sep 2026
Memory Is The Foundation. Put An Agent On Top.
BIMRI is free forever. When you want the whole machine, there are two roads.