# WhiteMagic — local-first memory and session continuity for AI agents

> WhiteMagic gives AI agents durable local memory and session continuity. 15 native Rust crates, 298 authored capabilities behind one NLU-routed `wm` MCP meta-router (a 9-tool agent lifecycle surface in tools/list; 61 routes curated on the default profile). 1.1µs dispatch latency and durable local memory across galaxies. No account; no usage telemetry off-device by default. Memory, prompts, and session content stay on your machine. MIT licensed.

## Install

```bash
curl -fsSL https://www.whitemagic.dev/install.sh?ref=index-md | sh
```

Alternatives: `npx whitemagic-mcp serve`, `cargo install whitemagic`, or `docker run -i lbailey94/whitemagic:9 serve`.
Verify: `wm --version` → wm 9.2.1; `wm selftest` runs 8 end-to-end invariants in ~1s. Run `wm grimoire` for the full readiness check (host → substrate → release → agent → memory → teach → continuity). Connect every detected editor/agent client in one command — `wm connect` (or `wm setup <client>` for one) — or manually over local MCP (`wm serve`). `wm update check` verifies the signed release manifest (Ed25519).

## Key facts

- Version: 9.2.1 (released September 20, 2026); 15 crates on crates.io; npm, Docker, and the official MCP registry.
- Latency: 0.0011 ms median dispatch (1.1µs), 900,000+ req/s throughput, zero GC pauses.
- Governance: Linux Landlock sandbox, Dharma graduated enforcement, Karma hash-chained audit ledger (Merkle-verifiable).
- Continuity: sessions survive restarts and crashes; backup/export a galaxy and restore it anywhere.

## For agents

- Discovery index (ARD): https://www.whitemagic.dev/.well-known/ai-catalog.json
- MCP server card: https://www.whitemagic.dev/.well-known/mcp/server-card.json
- A2A agent card: https://www.whitemagic.dev/.well-known/agent.json
- Tool manifest: https://www.whitemagic.dev/api/manifest.json
- Full context: https://www.whitemagic.dev/llms-full.txt
- API catalog (RFC 9727): https://www.whitemagic.dev/.well-known/api-catalog
- Contact (machine-readable): https://www.whitemagic.dev/.well-known/contact.json

## Links

- Repository: https://github.com/lbailey94/whitemagic
- Research: https://www.whitemagic.dev/research
- WhiteMagic: https://www.whitemagic.dev/whitemagic
- Setup guide: https://www.whitemagic.dev/whitemagic/guide
- Support: https://www.whitemagic.dev/support
- About: https://www.whitemagic.dev/about
- Contact: https://www.whitemagic.dev/contact