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

> WhiteMagic gives agents durable local memory and session continuity: 15 Rust crates, 298 authored capabilities behind one NLU-routed `wm` MCP meta-router (9-tool agent lifecycle surface; 61 routes curated on the default profile). MIT licensed. no usage telemetry off-device by default

Full page: https://www.whitemagic.dev/whitemagic

## Install

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

Alternatives: `npx whitemagic-mcp serve`, `cargo install whitemagic`, `docker run -i lbailey94/whitemagic:9 serve`.

## Workflow

1. `wm --version` — verify wm 9.2.1
2. `wm grimoire` — readiness walkthrough (host → memory-layer → release → agent → memory → teach → continuity)
3. `wm connect` — wire detected editors/agents over local MCP
4. `wm serve` — manual local MCP endpoint

## Machine surfaces

- MCP server card: https://www.whitemagic.dev/.well-known/mcp/server-card.json
- Tool manifest: https://www.whitemagic.dev/api/manifest.json
- Discovery index (ARD): https://www.whitemagic.dev/.well-known/ai-catalog.json
- Setup guide: https://www.whitemagic.dev/whitemagic/guide

Repository: https://github.com/lbailey94/whitemagic