Anamnesis

What is Anamnesis?

Anamnesis is a local-first, file-based memory layer for Claude Code that syncs automatically across all of your own machines. It captures project conventions, architecture decisions, fixes, and session summaries as plain markdown, indexed for fast retrieval and synced over your private network without any cloud account.

How to use Anamnesis?

Install by running uv tool install anamnesis-memory && anamnesis init. This registers the MCP server with Claude Code, installs session hooks, and configures the store at ~/.anamnesis. For cross‑machine sync, set up a git remote on a Tailscale mesh and run anamnesis init --remote <remote>. Claude Code gains five MCP tools: memory_search, memory_list, memory_status, memory_write, and memory_sync.

Key features of Anamnesis

• File-first memory stored as human‑readable, git diff-able markdown.
• Sub‑millisecond BM25 recall via a local SQLite FTS5 index.
• Robust sync via git over your private Tailscale mesh (database never corrupted).
• Claude‑Code‑native MCP server with read‑only auto‑query tools and session hooks.
• Optional reflection loop that distills session logs into durable, provenance‑tracked notes.
• A git‑like dashboard to browse, search, edit, and see memory history across machines.

Use cases of Anamnesis

• Carry your coding agent’s project knowledge when switching from desktop to laptop.
• Automatically capture and archive every session summary without manual steps.
• Synchronize learned conventions and fixes across a fleet of personal machines.
• Audit and edit your agent’s memory with full version history via the dashboard.

FAQ from Anamnesis

What does Anamnesis do?

Anamnesis provides a persistent memory layer for Claude Code that syncs across all your machines. It stores memory as markdown files, indexes them for fast retrieval, and syncs via git over your private network.

What are the prerequisites to use Anamnesis?

You need Claude Code, uv (the Astral tool installer), and git. For cross‑machine sync, you also need Tailscale installed on every machine and a shared bare git repo.

Where is my memory data stored?

All memory lives in ~/.anamnesis/memory/ as plain markdown files. A local SQLite FTS5 index is built from those files—the database is never synced, so it never corrupts.

Does Anamnesis require a cloud service?

No. Anamnesis is local‑first and syncs over your own private network via Tailscale. No cloud account or third‑party server is required.

How does cross‑machine sync work?

Sync uses a git repository over your Tailscale mesh. One always‑on machine hosts a bare git repo; each machine runs commit → pull --rebase → push. After pulling, the local SQLite index is rebuilt, making new notes searchable immediately. Conflicting edits surface as git conflicts.