AI Agents
iwe
A markdown knowledge graph with LSP for editors and MCP for agents.
★ 1.7k starsApache-2.0
View guide →Basic Memory: local-first MCP memory so you and your AI tools build a shared knowledge graph in Markdown
basic-memory is an open-source ai agents project by basicmachines-co (basicmachines-co/basic-memory on GitHub). It has 4,119 GitHub stars and 305 forks, is released under the AGPL-3.0 license, and was last updated on GitHub on 8 October 2026.
Install Basic Memory with uv (the README currently requires the prerelease flag).
Add the MCP server to Claude Desktop, Codex, Cursor, VS Code, or Claude Code with the documented config.
Ask your AI to save a decision or fact; watch it appear as a Markdown file in ~/basic-memory.
Open the same files in Obsidian or your editor, edit them, and let sync merge your changes with the AI's.
Memory is human-readable Markdown files you own — no proprietary store or lock-in.
Human edits and AI writes merge continuously instead of overwriting each other.
Observations and wikilinks in notes form a navigable graph your AI can traverse.
FastEmbed embeddings with full-text + vector hybrid search and optional reranking, on SQLite or Postgres.
Infer, validate, and diff note schemas so structured knowledge stays consistent as it grows.
Claude, Codex, Cursor, ChatGPT, and other MCP clients share the same memory; Obsidian works on the same files directly.
Clone the project and enter its directory (most users install the tool, next step).
git clone https://github.com/basicmachines-co/basic-memory.git
cd basic-memoryInstall Basic Memory as a uv tool (prerelease flag currently required per the README).
uv tool install basic-memory --prerelease=allowRegister the server with your client, then restart the client and ask it to save a memory.
claude mcp add basic-memory -- uvx --prerelease=allow basic-memory mcpBasic Machines (basicmachines-co) develops Basic Memory and offers an optional hosted Cloud.
Local use is free under AGPL-3.0. The optional Cloud (sync/mobile) is a separate hosted service offered by Basic Machines.
No — local embeddings (FastEmbed) and local files need no key or account.
Those hide memory in embeddings. Basic Memory keeps it as plain Markdown you can read, edit, and version, with a knowledge graph and search layered on top.
Run `uv tool install basic-memory --prerelease=allow`, add the MCP config to your client, restart it, and ask your AI to remember something.
A markdown knowledge graph with LSP for editors and MCP for agents.
High-performance code intelligence MCP server: your codebase as a persistent knowledge graph
One portable, local-first memory layer for every AI agent - Markdown-native, user-owned and self-evolving.
Local-first AI memory that runs offline on just 8 GB of RAM.
LongMemory: local-first memory for AI agents with temporal truth, provenance, and hybrid recall
The open-source memory layer for autonomous agents — knowledge-graph memory that emulates human memory
The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if basic-memory is not the right fit.
A personal AI that really does things — on any OS, with your data staying yours.
An agentic skills framework & software development methodology that works.
Agent harness optimization system with skills, memory and security for Claude Code, Codex and more
The agent that grows with you — a Python framework for adaptive AI agents.
DeepSeek's plugin-based agent harness where everything is a plugin.
Free and open — grab the source, star the repo, and start creating.