{ "markdown": "# WhiteMagic\n\nLocal-first memory and session continuity for coding agents.\n\nWhiteMagic gives an AI coding agent durable project memory over MCP: record\nimportant context, find it after restart, and carry useful decisions into the\nnext session — without sending your memory store to any hosted service.\n\n**You are an agent reading this repo?** Start with\n[skill.md](skill.md) (five-minute operational onboarding) and\n[llms.txt](llms.txt) (machine-readable index).\n\n```json\n{\n \"mcpServers\": {\n \"whitemagic\": {\n \"command\": \"wm\",\n \"args\": [\"serve\", \"--profile\", \"curated\"]\n }\n }\n}\n```\n\n## Status\n\n**WhiteMagic v9.** General release for AI coding agents.\n\n- **Supported platforms: Linux x86-64, macOS, Windows.**\n- The Linux x86-64 artifact is fully static — no glibc or distribution requirements.\n- Trusted, local-first, single-user operation with Landlock containment and firebreak guards.\n\n## What it does\n\nThe supported alpha contract:\n\n- trusted, local, single-user operation;\n- explicit MCP routes for dependable behavior;\n- durable memory creation and lexical search without an external model;\n- session record, replay, and cross-session continuity;\n- a complete backup, verification, and restore path;\n- no telemetry and no required WhiteMagic cloud service;\n- truthful degradation when optional models or embeddings are unavailable.\n\n## Install\n\nDownload the binary and its checksum from the\n[latest release](https://github.com/lbailey94/whitemagic/releases), then:\n\n```bash\nsha256sum -c wm-linux-x86_64.sha256\nchmod +x wm\nmkdir -p ~/.local/bin && mv wm ~/.local/bin/\n```\n\nIf `~/.local/bin` is not on your `PATH`:\n\n```bash\nexport PATH=\"$HOME/.local/bin:$PATH\"\n```\n\nOr use the install script (resolves the latest release and verifies the\nchecksum automatically):\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/lbailey94/whitemagic/main/scripts/install.sh | sh\n```\n\nVerify the installation:\n\n```bash\nwm --version # wm 9.0.0\nwm doctor # environment health check\n```\n\n## Connect an MCP client\n\nPoint any MCP client at:\n\n```bash\nwm serve --profile curated\n```\n\nThe server communicates over stdio and exposes a single `wm` meta-tool.\nExplicit routing is the dependable contract:\n\n- `wm(route=\"memory.create\", args={...})`\n- `wm(route=\"session.start\", args={...})`\n- `wm(route=\"tools.list\", args={})`\n\n`--profile curated` selects the supported memory/session surface and is the\ndefault when no profile is specified. Pass `--profile full` for the research\narchive surface (see below).\n\n## Privacy and data\n\n- Your store lives locally at `~/.local/share/whitemagic`. Nothing is sent to\n WhiteMagic-operated services; there is no telemetry.\n- Privacy flags exclude memories from responses and reasoning. **They are\n access controls, not encryption** — anyone who can read the store files can\n read the contents. Do not store credentials in memories.\n- Conversation capture happens through explicit tool calls, not automatically.\n\n## Backup and restore\n\nBack up the **whole store root** (LMDB database, search indexes, and all\nsession/state files — not just the `lmdb/` subdirectory):\n\n```bash\n# Stop the server first, then:\nwm backup # writes ~/whitemagic-backups//\nwm backup --out /path/to/external/disk # keep copies OFF the live machine\n```\n\nEach backup contains the full store plus a `SHA256SUMS` manifest. Restore\nafter a failure (this replaces the target store):\n\n```bash\nwm restore --backup ~/whitemagic-backups/whitemagic-backup- --force\nwm doctor # confirm health after restore\n```\n\nRestore verifies every file against the manifest before touching anything,\nand refuses tampered or incomplete backups. Notes:\n\n- `wm seal` / `wm verify` detect *integrity drift*; they do not recover data.\n Only a backup recovers data.\n- Transaction rollback (`transaction.rollback`) is an in-store, short-lived\n undo — not a substitute for backups.\n- Keep at least one backup on a different disk or machine.\n\n## Research surface (not part of the alpha contract)\n\nThe codebase contains a larger research system beyond the product boundary:\nautonomous cycles, dream consolidation, bicameral reasoning, an imagination\nengine, self-play training loops, polyglot sidecars (Julia/Haskell/Zig/Koka),\na signed multi-agent mesh, holographic memory coordinates, and a 237-tool\narchive reachable via `wm serve` without a profile restriction. These are\nresearch surfaces without product acceptance evidence; they may change or be\nremoved. Only surfaces documented in this README are part of the product\ncontract.\n\n## Building from source\n\nRequires Rust 1.85+:\n\n```bash\ncargo build --release\ncargo test # full test suite\ncargo clippy --all-targets\n```\n\n## Documentation\n\n- [`docs/QUICKSTART.md`](docs/QUICKSTART.md) — the two-process continuity demo\n- [`docs/MCP_CONFIG_GUIDE.md`](docs/MCP_CONFIG_GUIDE.md) — client configuration\n- [`docs/MULTI_LAPTOP.md`](docs/MULTI_LAPTOP.md) — moving between machines (backup/restore, session carry)\n- [`CHANGELOG.md`](CHANGELOG.md) — release notes\n- [`SECURITY.md`](SECURITY.md) — reporting vulnerabilities\n\n## Migrating from v26 (legacy Python)\n\nIf you ran the retired Python version:\n\n```bash\nwm migrate --v2-dir ~/.whitemagic/users/local/galaxies --dry-run # preview\nwm migrate --v2-dir ~/.whitemagic/users/local/galaxies # migrate\n```\n\n## License\n\n[MIT](LICENSE) © Lucas Bailey and WhiteMagic Contributors\n\n## Support and security\n\n- Support: open an issue at\n \n- Security: email (please do not open public\n issues for security reports)\n", "bytes": 5682, "sha": "001d3e8d034be802b5185bac4658f55be2f83e90750ead8e052cd388f402ce18", "repo_slug": "lbailey94/whitemagic", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_lbailey94_whitemagic_mcp_69850bbb/readme" }