Anamnesis

Name: Anamnesis
Author: oscardvs

@oscardvs

代码仓库主页

关于 Anamnesis

Cross-machine memory for Claude Code: local-first, file-based agent memory that syncs across your own machines.

基本信息

分类

AI 与智能体

许可证

Apache-2.0

运行时

python

发布者

oscardvs

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "anamnesis": {
      "command": "uvx",
      "args": [
        "anamnesis-memory",
        "serve"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.