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 BMFOSS for 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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/basicmachines-cobasic-memory.svg)](https://yunodb.com/tools/basicmachines-cobasic-memory?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/basicmachines-cobasic-memory?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/basicmachines-cobasic-memory.svg" alt="Featured on YunoDB" height="20"></a>