Manage local knowledge in Markdown files with automatic bi-directional sync to LLMs. Built for developers who want persistent, version-controlled memory without external services.
io.github.basicmachines-co/basic-memory
Local install
STDIO
No auth required
How models use it and what it is built for.
Manage local knowledge in Markdown files with automatic bi-directional sync to LLMs. Built for developers who want persistent, version-controlled memory without external services.
Local install — runs as a subprocess.
Where to find authoritative docs and source for Basicmachines Co Basic Memory.
Paste any of these into Agent Studio after connecting Basicmachines Co Basic Memory.
Common questions about connecting and running Basicmachines Co Basic Memory.
How does bi-directional sync work between Markdown files and the LLM?
The server watches your local Markdown files and syncs changes into the LLM context automatically. When the LLM updates memory, those changes write back to your Markdown files, keeping everything in sync.
Do I need a cloud account or API key to use basic-memory?
No. basic-memory is local-first, meaning all your knowledge lives in Markdown files on your machine. There are no external services or accounts required.
Can I version-control my memories with Git?
Yes. Since memories are stored as Markdown files, you can commit them to Git like any other code, giving you full version history and collaboration.
What format do memory files need to be in?
Memories are stored as standard Markdown files. The server reads and writes `.md` files, so you can edit them directly in your editor or through the MCP interface.
How is basic-memory different from just pasting notes into a chat?
basic-memory persists your knowledge across sessions and automatically keeps it in sync with the LLM. You don't have to re-paste context every conversation, and changes flow bidirectionally between files and the LLM.
MCP Playground runs 10,000+ hosted MCP servers — GitHub, Linear, Notion, Stripe, Sentry and more — across Claude, GPT, Gemini, DeepSeek and 30+ AI models. Compare model answers side-by-side, save agent presets, share runs. Zero install.
Open Agent Studio