basic-memory
AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord: https://discord.gg/tyvKNccgqN
What is basic-memory?
AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord: https://discord.gg/tyvKNccgqN
Overview of basic-memory
What it is
Basic Memory is an open-source tool that gives AI conversations persistent memory. It stores knowledge as Markdown files on the user's disk (local-first) and syncs with AI clients via the Model Context Protocol (MCP). A cloud-hosted version is also available. The project is licensed under AGPL-3.0.
Key features
- Local-first: plain text Markdown files stored on the user's disk, forever.
- Two-way sync: both AI and humans can read and write to the same files; sync keeps them in step.
- Real knowledge graph: observations and wikilinks compound into context.
- Semantic search: find notes by meaning, not just keywords, with optional cross-encoder reranking.
- MCP-native: works with every major AI client and IDE (Claude, Codex, Cursor, ChatGPT, etc.).
- Progressive tool discovery: every tool is tagged with behavior hints (read-only, destructive, idempotent) so agents pick the right tool on demand.
- Cloud, optional: sync across devices when desired; never required.
Use cases
- Never re-explain your project to your AI again.
- Team collaboration: shared cloud workspace where knowledge is immediately available to all teammates and their AI assistants.
- Personal knowledge base that both you and your AI can read, write, and search.
- Running log of learnings and ProTips across projects.
Getting started
Two paths: cloud or local install. Cloud (30 seconds): Sign up at basicmemory.com, connect your AI client. $15.00/mo locked for life, 7-day free trial. Local install (2 minutes): Requires Python via uv. Run: bash uv tool install basic-memory --prerelease=allow For Postgres deployments with Milvus vectors: bash uv tool install basic-memory[milvus] --prerelease=allow Then configure your AI client (see repository README for details).
License and pricing
- Local install: free forever under AGPL-3.0.
- Cloud: $15.00/mo locked for life (regular price $19), 7-day free trial. OSS users can use code
BMFOSSfor 20% off for 3 months. One plan, no tiers, unlimited notes and projects. - Source code is AGPL-3.0 for both paths.
Based on the project's public README and repository metadata.