WhiteMagic — governed local memory for agent continuity MCP server

WhiteMagic

Local-first memory and session continuity for coding agents.

WhiteMagic gives an AI coding agent durable project memory over MCP: record important context, find it after restart, and carry useful decisions into the next session — without sending your memory store to any hosted service.

You are an agent reading this repo? Start with skill.md (five-minute operational onboarding) and llms.txt (machine-readable index).

{
  "mcpServers": {
    "whitemagic": {
      "command": "wm",
      "args": ["serve", "--profile", "curated"]
    }
  }
}

Status

WhiteMagic v9. Release channel: open alpha — public alpha for AI coding agents. The version number is a compatibility signal; the channel is an evidence claim (beta and stable each require their own exit conditions, not a version milestone).

• Install path: Linux x86-64 — fully static (musl) build, no glibc or distribution requirements. macOS and Windows binaries are published in every release but are not yet install-gated.
• Support window: the current minor and the previous minor on the Linux x86-64 line receive fixes; older minors are archival. macOS and Windows remain published but unsupported — see SECURITY.md.
• Trusted, local-first, single-user operation with Landlock containment and firebreak guards.

What it does

The supported alpha contract:

• trusted, local, single-user operation;
• explicit MCP routes for dependable behavior;
• durable memory creation and lexical search without an external model;
• session record, replay, and cross-session continuity;
• a complete backup, verification, and restore path;
• no telemetry by default and no required WhiteMagic cloud service;
• truthful degradation when optional models or embeddings are unavailable.

Install

Download the binary and its checksum from the latest release, then:

sha256sum -c wm-linux-x86_64.sha256
chmod +x wm
mkdir -p ~/.local/bin && mv wm ~/.local/bin/

If ~/.local/bin is not on your PATH:

export PATH="$HOME/.local/bin:$PATH"

Or use the install script (resolves the latest release and verifies the checksum automatically):

curl -fsSL https://www.whitemagic.dev/install.sh?ref=readme | sh

Other channels

npx whitemagic-mcp serve                     # npm (no global install)
cargo install whitemagic                     # crates.io
docker run -i lbailey94/whitemagic:9 serve   # Docker Hub

Adoption snapshot (2026-09-13): 759 npm downloads/30d · 1,846 Docker pulls · 67 crates.io downloads. Package installs are independent of the installer and grew without any website CTA — the substrate chooses its own doors.

Verify the installation and see the product work end to end:

wm --version    # wm 9.2.1
wm quickstart   # 30-second two-process continuity demo (isolated store)
wm grimoire     # guided first-run: host, substrate, agent wiring, vocabulary, continuity

wm doctor is a troubleshooting tool, not a setup step — run wm doctor --deep when something looks wrong.

Everyday commands

wm status         # is WhiteMagic ready? (store, counts, index, last backup)
wm selftest       # 5-second end-to-end invariant check (throwaway store)
wm connect        # wire every detected MCP client (dry run first; add --write)
wm setup          # list clients / per-client setup (wm setup <client> --write)
wm update check   # is a newer signed release available? (notify-only)

Connect an MCP client

Point any MCP client at:

wm serve --profile curated

Shortened. The full README is on GitHub.