Changelog

Notable changes in each Basic Memory release, most recent first. For complete patch-by-patch notes, see All releases below.

v0.22 — Team-safe cloud push and pull

June 2026 · v0.22.0 · v0.22.1

v0.22.0 makes cloud sync safe for teams. New bm cloud push and bm cloud pull commands transfer changes additively — they never delete files on the destination — so you can collaborate on a shared team workspace without risking a teammate's work. They model git push / git pull: conflict-aware, with --on-conflict options (fail, keep-cloud, keep-local, keep-both) when a file differs on both sides. The mirror-style bm cloud sync command remains personal-only and exits with an error on team workspaces.

Also in v0.22.0: search improvements, more capable bm tool and bm status commands, and a long list of MCP tool and embedding reliability fixes. See Cloud Sync for the full push/pull workflow.

The v0.22.1 patch fixed first-run reliability and shipped a few MCP fixes and parity additions:

• Fresh installs no longer get stuck when the projects table is empty — Basic Memory routes you to project setup and promotes your first project to the default automatically
• Sync skips projects without a valid local path and ignores stale projects left in the database but missing from your config
• MCP qualified project routes resolve workspace display names and tenant ids correctly
• search_notes comma-splits note_types, entity_types, and categories, matching how tags already behave
• write_note gains a workspace parameter for parity with edit_note
• Faster CLI startup — heavy imports are deferred out of the command path

v0.21 — Workspace-aware everywhere

May–June 2026 · v0.21.0

Every MCP tool and CLI command now routes through the same workspace/project model, and search and sync are noticeably faster.

• Cross-workspace discovery — MCP project listing spans every accessible cloud workspace, so team projects show up without switching workspaces first, and bm project list includes projects from every workspace
• Create projects by workspace — create_memory_project(workspace=...) from MCP, and bm project add --visibility for cloud projects
• Parameter aliases — MCP tools accept training-data-friendly aliases (q / search / text for query, etc.) so assistants reach for them naturally
• bm orphans — lists entities with no incoming or outgoing relations in the knowledge graph — notes not yet linked to anything
• Breaking change — unquoted multi-word text before a wikilink no longer parses as a custom relation type. Use single-token types like relates_to [[Target]], or quote multi-word types: "relates to" [[Target]]

Notable patches: v0.21.5 fixed workspace/project routing for MCP, and v0.21.6 consolidated the satellite repositories into the main basic-memory tree and shipped a redesigned Claude Code plugin — a memory bridge with a guided setup interview, capture skills, and team workspace support — alongside Codex, Hermes, and OpenClaw integration packages.

v0.20 — Auto-update

March 2026 · v0.20.0

A default-on auto-update system keeps CLI installs current, with a new bm update command (--check to check only). Install-source detection handles Homebrew and uv tool installs with the right upgrade flow for each, and MCP servers check silently in the background. Patches fixed API-key authentication for CLI cloud commands (previously only OAuth worked) and Homebrew update detection.

v0.19 — Semantic search and schemas

March 2026 · v0.19.0

The biggest release of the docs era:

• Semantic vector search for SQLite and Postgres with FastEmbed embeddings and hybrid keyword + vector fusion
• Schema system — schema_infer, schema_validate, and schema_diff for validating and evolving note structure
• Per-project cloud routing with API key authentication — route individual projects through cloud while others stay local
• JSON output mode for MCP tools and CLI commands
• Project-prefixed permalinks for unambiguous cross-project references
• write_note overwrite guard — writing to an existing path returns an error unless overwrite=true
• Upgraded to FastMCP 3.0 with tool annotations

Upgrading from v0.18? The v0.19.0 release notes cover the configuration and behavior changes.

All releases

Full release notes for every version, from GitHub: