Basic Memory
Start Here

Why Basic Memory

Your AI already has memory features. Here's why you still want a knowledge base you own — and how Basic Memory is different from the alternatives.

Every AI tool is adding memory. Claude has CLAUDE.md and auto memory. ChatGPT remembers facts about you. Obsidian users have been doing this with markdown for years. And a new wave of startups is building memory-as-a-service on top of databases.

So why Basic Memory?

Because none of these solve the whole problem. They each handle a piece of it, but they leave gaps that matter more as your knowledge grows.


The three alternatives

1. Built-in AI memory

Claude, ChatGPT, Cursor, and others now ship with some form of memory. Claude Code has CLAUDE.md files and auto memory. ChatGPT has saved memories and reference chat history. These are useful for quick preferences — "I use TypeScript," "I'm vegetarian," "use 2-space indentation."

Where it falls short:

  • Short-form only. ChatGPT memories are single sentences. Claude Code's auto memory index caps at 200 lines. You can't store a detailed architecture decision, a meeting summary, or a research synthesis.
  • Siloed. Claude's memory only works in Claude. ChatGPT's only works in ChatGPT. If you use more than one AI tool, your knowledge is fragmented. A decision captured in Claude Code isn't available when you switch to Cursor or ChatGPT.
  • Not searchable. There's no semantic search, no knowledge graph, no way to ask "find everything related to our authentication approach" and get structured results.
  • Not yours to keep. If the platform changes its terms, shuts down, or you switch tools, your memories don't come with you.

Basic Memory works alongside built-in memory — it doesn't replace it. Use built-in memory for preferences. Use Basic Memory for everything deeper. See Basic Memory vs Built-in AI Memory for the detailed comparison.


2. Obsidian

Obsidian is excellent — and it's the approach closest to Basic Memory's philosophy. Plain markdown files, wiki links, graph view, local-first. With the recent addition of headless mode and CLI commands, Obsidian can even be integrated with AI tools through skills and automation.

If you're already an Obsidian user, you're halfway to Basic Memory's worldview. The question is what you get by adding Basic Memory on top.

What Basic Memory adds to the Obsidian experience:

  • Semantic search. Obsidian's search finds exact text matches. Basic Memory finds notes about "error handling" when you wrote "exception management" — it searches by meaning, not just keywords. Hybrid search combines vector similarity with text matching for the best of both.
  • A semantic knowledge graph. Basic Memory parses observations and relations from your notes to build a typed knowledge graph. You can ask "what depends on this decision?" and traverse connections across your entire knowledge base — not just follow backlinks, but navigate structured relationships.
  • Schemas. Define what a meeting note or decision record should contain. The AI validates notes against schemas automatically, keeping your knowledge base consistent as it grows.
  • Cloud access. Your knowledge is available from any device, with any AI tool. Basic Memory Cloud means your notes aren't stuck on one machine — use them from Claude Desktop at work, ChatGPT on your phone, or Cursor on your laptop.
  • Cross-tool portability. Notes created in Claude Code are searchable in ChatGPT, editable in Cursor, and visible in Obsidian. One knowledge base, every AI tool you use.

The best part: you don't have to choose. Obsidian is a great companion for Basic Memory. Point both at the same folder and you get Obsidian's graph view and rich editing, plus AI-powered semantic search, schemas, and cloud access on top.


3. Database-only memory services

A growing number of startups offer AI memory as a service — Mem0, Letta, Supermemory, and others. They store memories in databases behind APIs, often with vector search and cloud infrastructure.

Where it falls short:

  • You can't read what the AI knows. Your knowledge lives in a database you access through an API. You can't open a file, read what's there, fix a mistake, or reorganize your notes. The AI's understanding of you is opaque.
  • You can't edit it naturally. Want to refine a decision the AI captured? You need to go through the API or a dashboard. You can't just open a markdown file in your editor and fix it.
  • Vendor lock-in. Your knowledge is in a proprietary format in someone else's database. If the service shuts down, changes pricing, or pivots, migrating is painful — if it's possible at all.
  • Not built for humans. These tools treat memory as something the AI manages about you. Basic Memory treats knowledge as something you and your AI build together. You're a participant, not a subject.

Plain text files from 1975 are still readable today. Can you say that about any proprietary database format?


What makes Basic Memory different

Basic Memory takes a different position from all three alternatives:

Your memory is a file you can read. Not a database entry you can't see. Not a single sentence in a settings page. A full markdown note with observations, relations, and tags — readable in any editor, trackable with git, portable forever.

Your AI is a collaborator, not a recorder. Both you and your AI read and write the same files. You capture rough notes, the AI structures them. The AI writes a summary, you refine it. Knowledge flows in both directions.

It works across every AI tool. Notes created in Claude Code are available in ChatGPT, Cursor, Gemini, or any MCP-compatible tool. One knowledge base, many interfaces.

Search finds meaning, not just keywords. Semantic search finds notes about "login security" even when you wrote "authentication hardening." Combined with text search, metadata filtering, and knowledge graph traversal, you can find anything in your knowledge base.

Structure grows with you. Start with simple notes. Add observations and relations when they're useful. Define schemas when you want consistency. The system meets you where you are.


The best of all worlds

You don't have to choose one approach. The strongest setup combines them:

  • Built-in memory for quick preferences your AI tool handles automatically
  • Basic Memory for structured knowledge, decisions, research, and context
  • Obsidian for visual graph exploration and rich editing alongside Basic Memory
  • Git for version history on your knowledge base

Basic Memory is the connective layer that makes your knowledge available everywhere, searchable by meaning, and yours to keep.


Get started

Quickstart: Cloud

Connect in 2 minutes, no install needed.

Quickstart: Local

Run everything on your machine.

Basic Memory vs Built-in AI Memory

Detailed comparison with Claude, ChatGPT, and Cursor memory.

What is Basic Memory

How it works under the hood.