All blogs
Release

Memoir v0.2.1: search, a terminal UI, and a sturdier store

The release that turns last month's vector-search preview into shipping commands. v0.2.1 adds file and folder ingestion with semantic search, a read-only terminal UI, a branch switcher in the web UI, a new default storage backend, and per-call branch routing for the CLI.

Search you can point at files

Last month we walked through versioned vector search as a coming-soon deck. v0.2.1 turns it into commands. memoir watch ingests a file or folder; memoir search ranks by semantic similarity. The embeddings live inside the same versioned store as the rest of your memory — same commits, same branches, no second database to keep in sync.

The practical effect is the one the deck promised: a Memoir entry no longer has to stay small to stay findable. Point it at a long document and still pull out the right sentence later.

Read your memory where you work

Two ways to browse the store got better in this release:

  • A read-only Textual TUI. Walk the taxonomy from the terminal — no browser, no leaving the shell.
  • A branch switcher in the web UI topbar. Memory is per-branch, so jumping between branches is now a click rather than a restart. The UI also picked up performance fixes along the way.

A sturdier store, finer routing

Two changes for anyone operating Memoir day to day:

  • File backend by default. New stores now use the File backend; the Git backend was hardened for setups that keep using it.
  • Per-call branch routing for the CLI. Target a specific branch on a single command — no need to switch the store's active branch first.

Beyond Claude Code

v0.2.1 integrates the Memoir Codex plugin, extending the same versioned memory beyond Claude Code. The plugin pins to memoir-ai 0.2.0, and the code-change hook was refined to record edit rationale more concisely.

The short list

  • memoir watch / search — file and folder ingestion with vector search
  • Read-only Textual TUI
  • Branch switcher in the web UI topbar, plus UI performance fixes
  • File backend default for new stores; hardened Git backend
  • Per-call branch routing for the CLI
  • Memoir Codex plugin, pinned to memoir-ai 0.2.0

Read the full v0.2.1 release notes

Thanks to @scdozier for a first contribution in this release.