WhiteMagic — governed local memory for agent continuity

io.github.lbailey94由 GitHub 账号 lbailey94 发布v11.0.0更新于 Nov 8, 2026

Governed local-first memory and continuity for AI agents — signed receipts, optional hosted lane.

发布方自己的服务:Memory.fit

已验证Streamable HTTP可网页运行效率与工作流知识与记忆AI 与机器学习

概览

AI 生成的概览

面向 AI 编程代理的本地优先记忆与会话连续性服务器,提供可检索的记忆星系、检查点和签名回执。

可以做什么
  • 创建、更新、固定、批量导入和批量读取记忆,并维护可校验的修订链
  • 通过 BM25 与向量融合进行搜索、批量搜索、结构化查询、过滤、计数、聚合和标签列举
  • 管理记忆星系:列出、创建和分叉独立分区
  • 记录与恢复会话:启动会话、记录轮次、保存检查点,以及回忆、重放和生成摘要
  • 签发并校验连续性回执,查看底层统计、关联图和系统不变量
  • 查看沙箱状态、执行分诊与评估,并与远端节点同步
适用场景
适合希望 AI 编程代理跨会话记住决策与上下文、并能无损交接工作的场景,尤其是需要可验证签名连续性记录时。也适合希望记忆保存在本机而非托管服务中的团队。
运行要求
可使用 mcp.whitemagic.dev 的托管端点(streamable HTTP),或本地 npm 包(npx whitemagic-mcp@next)与 Docker 镜像;本地方式首次运行会下载并校验官方 wm 二进制。预览版支持 glibc 2.39+ 的 Linux x86-64/arm64 与 macOS arm64,Windows 与 Intel macOS 使用稳定版。托管免费层无需账号,评估密钥与 OAuth 可选。
安装前请注意
记忆内容默认保存在本机,但托管通道会把查询发送给第三方,超出免费额度后按次通过 x402 以 Base 上的 USDC 结算,会实际花费资金。写入类工具会创建、更新、固定、分叉和导入记录,mesh 同步会把数据发送到远端节点。请固定包版本,因为未固定版本会拉取另一条稳定线。

安装

在 SourceWeft 中

  1. 打开 控制台中的 WhiteMagic — governed local memory for agent continuity,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.lbailey94%2Fwhitemagic-mcp/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "whitemagic-governed-local-memory-for-age": {
      "type": "http",
      "url": "https://mcp.whitemagic.dev/mcp"
    }
  }
}

README

whitemagic-mcp

Persistent memory and session continuity for AI coding agents, over MCP. WhiteMagic is one Rust binary — local-first, no telemetry by default, MIT — and every handoff can be signed as a verifiable continuity receipt.

Works with Claude Code, Claude Desktop, Cursor, Codex, VS Code, opencode, Antigravity, and Devin Desktop — per-client configs: https://www.whitemagic.dev/whitemagic/guide

This package installs and runs the official wm binary from the GitHub releases (checksum-verified at install time) so an MCP client can launch it without a manual download step.

Quick start (no install step)

The local, full-write path straight from npm — the package downloads and checksum-verifies the official wm binary on first run. Use the @next dist-tag: npm @latest still resolves the stable v9 line.

bash
npx -y whitemagic-mcp@next serve --profile cyberbrain

MCP client config:

json
{  "mcpServers": {    "whitemagic": {      "command": "npx",      "args": ["-y", "whitemagic-mcp@next", "serve", "--profile", "cyberbrain"]    }  }}

Or try the binary directly:

bash
npx -y whitemagic-mcp@next selftest   # invariant self-test + host diagnosticsnpx -y whitemagic-mcp@next --version  # wm 10.7.1npx -y whitemagic-mcp@next doctor     # environment health check

The binary is cached under ~/.cache/whitemagic/bin/<release-tag>/ (respects XDG_CACHE_HOME). @next tracks the v10 line; unpinned @latest installs fetch the stable v9 line instead. Pin the exact release with [email protected], or override the release tag with WHITEMAGIC_RELEASE.

Try it without installing (hosted read-only lane)

The evaluation lane runs at https://mcp.whitemagic.dev/mcp (streamable-http; no SLA). Free paths, no account needed:

  • keyless discovery (initialize / tools/list) for directory probes;
  • an anonymous free tier — 3 calls/day per client IP, no key and no header;
  • instant evaluation keys at https://mcp.whitemagic.dev/keys (50 recalls/day, email optional);
  • OAuth 2.1 for MCP clients that speak it.
bash
claude mcp add whitemagic-mcp --transport http https://mcp.whitemagic.dev/mcp

Beyond the free paths, metered calls settle per call via x402 (USDC on Base), keyless — no account, no invoice. The npm package remains the local, full-write path.

Platforms

The Gen3 preview publishes Linux x86-64 and arm64 binaries requiring glibc 2.39+, plus macOS arm64. Its active installers are certified against the published release in CI. Windows x64 and Intel macOS use the separate stable Gen2 line (whitemagic-mcp@latest); they are not in this preview's asset matrix. Downloads prefer the compressed .gz distributable when the release ships one (~58% smaller) and fall back to the raw binary otherwise. No asset for your platform? Build from source: https://github.com/lbailey94/whitemagic#install

MCPB bundle

Build the dynamic MCPB bundle with mcpb/build.sh from this package directory. It includes the complete launcher and lets the client select cyberbrain or full through actual server arguments. Live tools/list owns discovery.

The old static Smithery catalog is retained as historical source and is not emitted as a release variant. It needs qualification against an exact runtime version and selected profile before it can describe this Gen3 bundle.

Privacy

Your memory store lives on your machine. wm does not phone home; this installer contacts GitHub releases only to download the binary and its checksum. See PRIVACY_POLICY.md.

mcp-name: io.github.lbailey94/whitemagic-mcp

来源:npm/whitemagic-mcp/README.md,提交 fe105a5

工具

59

wm

WhiteMagic Meta-Tool

Hosted router for available hosted tools. Use tools/list to discover supported routes.

输入参数argsrouteactionthought

memory.create

Store Memory

Store a new memory in the holographic substrate with bijective UUID, 6D projection, and galaxy routing. (READ-ONLY: mutations refused)

输入参数tagstitletopicgalaxysourcecontent必填event_timeimportance

memory.temporal_query

Query Temporal Evidence

Query scoped temporal source assertions and their statuses; results are evidence, not verified facts.

输入参数mode必填subject必填known_atvalid_atnamespace必填predicate

memory.read

Read Memory

Retrieve a specific memory by its numeric record ID or UUID string.

输入参数id必填galaxy

memory.list

List Memories

List memories with pagination (limit, offset) and galaxy filtering.

输入参数limitgalaxyoffsetexclude_tags

memory.hybrid_recall

Hybrid Recall

Compatibility alias of memory.search with BM25 + dense vector fusion.

输入参数limitquery必填sinceuntilgalaxymin_scoremin_trusttime_basisinclude_coldmin_importancecold_scan_limitmin_score_ratio

galaxy.list

List Galaxies

List all active sovereign memory galaxies, their record counts, sample tags, and starter guide status.

无需输入参数。

galaxy.fork

Fork Galaxy

Fork an existing galaxy partition into a new sovereign galaxy branch (e.g. 'guide' -> 'project-alpha'). (READ-ONLY: mutations refused)

输入参数source必填target必填

galaxy.create

Create Galaxy

Establish a new sovereign galaxy namespace with an initial genesis beacon. (READ-ONLY: mutations refused)

输入参数name必填description

session.record

Record Session Turn

Record a session turn (decision, breakthrough, summary) for compounding continuity. (READ-ONLY: mutations refused)

输入参数roletrackcontent必填resolvesqualifierturn_typeimportancesession_idsupersedes

session.continuity

Session Continuity

Recall where the previous session left off: recent turns, salient anchors, unresolved DiAML arcs, related track crystals, checkpoints, and open queues.

输入参数nsincetrackuntilsession_idtoken_budgetmax_content_bytescurrent_session_idmax_response_bytesinclude_briefing_text

session.start

Start Session

Start or resume an agent session for persistent continuity across tool invocations.

输入参数usertitle

memory.update

Update Memory

Update an existing memory by writing a superseding record (or consolidating into an existing record) and a durable revision entry (prior/new content hashes, timestamp, reason). (READ-ONLY: mutations refused)

输入参数id必填reasoncontentsuperseded_by_id

memory.revisions

Memory Revisions

List the durable revision chain of a memory, or verify it by recomputing content hashes and chain links.

输入参数id必填action

session.checkpoint

Session Checkpoint

Save a structured checkpoint (summary, git state, next queue, open flags, track/lease metadata) for lossless handoffs. (READ-ONLY: mutations refused)

输入参数trackbranchcommitsummarylease_idnext_queueopen_flagssession_idcrystallizetests_green

memory.ingest

Ingest Memories

Ingest inline items (items / items_jsonl / text) or a JSONL/text file (source) via the batch-create path; returns real counts and refuses malformed input. (READ-ONLY: mutations refused)

输入参数textitemslimitgalaxyredactsourcedry_runitems_jsonl

receipts.emit

Emit Continuity Receipt

Emit a signed continuity receipt: kind 'session' signs a digest of the last `limit` session-log turns; kind 'state_transition' signs a store-state snapshot chained to the prior emitted receipt. 'task' receipts are not supported.

输入参数outkind必填limitsession_id

receipts.verify

Verify WhiteMagic Profile Receipt

Verify one supported WhiteMagic receipt profile (including emitted session/state_transition continuity receipts) against the existing local gate key. This is not a general Continuity Receipt bundle verifier.

输入参数bundle必填

memory.count

Count Memories

Count memories matching optional filters without returning full payload content.

输入参数galaxy

memory.stats

Memory Substrate Statistics

Substrate statistics: epoch, total records, relations, postings, and crash-consistency invariants.

输入参数galaxy

memory.tags

Memory Tags Vocabulary

List the tag vocabulary with usage counts.

输入参数limitgalaxy

memory.aggregate

Aggregate Memories

Aggregate over the matched record set: numeric fields (importance, created_at, epoch) support count/sum/avg/min/max; categorical fields (source, domain, class, status, galaxy) support count only. Unsupported field/op is refused.

输入参数opfieldlimitquerymetric

memory.associations

Associative Graph Neighbours

Traverse associative graph neighbours of a memory over hub-penalized multi-hop spreading activation.

输入参数id必填hopsdecaylimitdirection

memory.batch_read

Batch Read Memories

Read multiple memories by their UUID or numeric record IDs in a single call.

输入参数ids必填galaxy

memory.query

Query Memories

Structured query over memories with filters, ordering, and field projections.

输入参数tagslimitquerygalaxycreated_aftercreated_beforemax_importancemin_importance

memory.filter

Filter Memories

Filter memories by metadata (tags, minimum importance, recency).

输入参数tagslimitquerygalaxyoffsetexclude_tagscreated_aftercreated_beforemax_importancemin_importance

memory.pin

Pin Memory

Durably pin a critical memory against decay, sweep compaction, and forgetting, or release it with pinned=false. (READ-ONLY: mutations refused)

输入参数id必填galaxypinned

memory.search_batch

Batch Search Memories

Execute multiple memory search queries concurrently with sub-millisecond retrieval.

输入参数limitqueries必填

session.list

List Sessions

List session lanes with turn count, last timestamp, latest preview, start-marker flag, and checkpoint presence.

输入参数limitsession_id

session.recall

Recall Session Content

Recall specific interactions and turns within a targeted session (optional content query and limit).

输入参数limitquerysession_id

session.replay

Replay Session

Replay the chronological trajectory of a session: 'full' returns all turns, 'selective' filters by min_importance/turn_types, 'progressive' keeps the most recent turns within token_budget, and 'hybrid' combines earlier high-salience anchor turns (up to 30% of token_budget) with the most recent turns.

输入参数nmodesincetrackuntilsession_idturn_typestoken_budgetmin_importancecurrent_session_idinclude_superseded

session.digest

Session Digest

Compose a digest from typed session-log turns and the latest checkpoint (markdown text plus JSON, with optional codex crystallization).

输入参数nsession_idcrystallize

mandala.status

Mandala Kekkai Sandbox Status

Status of the Mandala microsecond Landlock sandbox, ABI level, POSIX rlimit bounds, and capability ledger.

无需输入参数。

mandala.triage

Mandala JEV Triage Gate

Non-autoregressive System 1 JEV/Layla triage gate (<30 ns) to classify tasks and predict marginal utility and confinement tier.

输入参数costriskinquiryutilityvariance

mandala.evaluate

Mandala Confinement Evaluation

Execute a candidate mutation in an ephemeral Landlock sandboxed Kekkai and notarize with Spec 0.5 receipt. (READ-ONLY: mutations refused)

输入参数commandcandidate_id必填mutation_kind

mesh_sync

Mandala P2P Mesh Sync

Synchronize the Substrate with a remote peer node over the sovereign TCP protocol.

输入参数peer必填batch_size

gnosis.status

Gnosis Self-Model Status

System epistemics, self-model calibration, and invariant health status.

无需输入参数。

gnosis.explain

Gnosis Explain

Explain internal architectural invariants, memory schemas, or routing logic.

输入参数conceptis_spawnis_writeargs_hashtool_nameis_networkhas_purpose

decision.shortlist

System 0.5 Route Shortlist (Static Embeddings)

Rank candidate routes/actions for a state with the local static-embedding retrieval organ (no network, no model forward pass) and emit a signed shortlist receipt. (READ-ONLY: mutations refused)

输入参数kstate必填routescascadetenant_idsession_idtask_classcatalog_pathemit_receiptmargin_threshold

decision.deliberate

System 1.5 Local Deliberator (Grammar-Constrained SLM)

Deliberate over ambiguous candidate options using local grammar-constrained SLM inference (100% schema guarantee, no hallucination) and emit a signed deliberation receipt. (READ-ONLY: mutations refused)

输入参数intent必填candidates必填emit_receipt

decision.outcome

Record Decision Outcome

Sign and journal the outcome of a dispatched decision/shortlist receipt (success, failure, corrected) for the learning loop. (READ-ONLY: mutations refused)

输入参数noteoutcome必填tenant_idsession_idreceipt_path必填corrected_route

sutra.cast

Dispatch Sutra / Taoist Mudra

Evaluate and dispatch a zero-allocation Taoist Hand Seal / Sutra Codon (e.g. '觀 證 行', 'Kek-01-Seal'). Validates preconditions, computes Kekkai sandbox boundaries, and executes bound Action Skeleton cycles or transmits swarm mudra packet to P2P peer. (READ-ONLY: mutations refused)

输入参数peercodon必填trackstrictdry_runexecuteresolvessession_id

sutra.compile

Compile Intent to Sutra

Compile high-level natural language intent into an optimal compound Sutra codon and Taoist Mudra formula using static Model2Vec embeddings or lexical centroids.

输入参数query必填

sutra.canon

Sutra Canon

Inspect the canonical 12-glyph logoglyphic Sutra canon, alchemical dual-mappings, Taoist hand seals (印诀), and bound Action Skeletons.

无需输入参数。

sutra.list

List Canonical Mudras

List all recognized canonical compound Taoist Mudras (印诀式), their formulaic compositions, preconditions, and primary execution skeletons.

无需输入参数。

sutra.hexagram

I Ching Hexagram Macro-Action

Inspect or mutate one of the 64 King Wen I Ching Hexagram Macro-Actions. Returns King Wen number, binary symbol, trigrams, Wu Xing element, default codon, nuclear inner, complement (反), reverse (覆), and dynamic line mutation transformations.

输入参数query必填mutate_line

sutra.route

Catuṣkoṭi Dialectical Cognitive Router

Route an inquiry or task intent through the Catuṣkoṭi K3 dialectical cognitive router. Employs Kleene 3-valued logic to resolve dialectical tensions (competing action vectors like execute vs dry-run) and matches 64-hexagram macro-actions, returning System 0/1/2 triage tier, resting potential, plasticity, and bound Action Skeleton.

输入参数inquiry必填utility

sutra.contract

Catuṣkoṭi Answer Contract

Resolve or verify bounded caller-asserted temporal assertions. Results describe the supplied metadata; this tool does not authenticate sources or enforce native-store sanctuary access.

输入参数modeattestproposalquestionassertionsrequest_json

legion.summon

Summon GAS Shadow Clone Legion (Experimental Simulation)

[Experimental / Simulation] Run a deterministic Rayon stack-codon cohort simulation across CPU cores. Evaluates N candidate codon variants across four archetypes (Adversarial, Refactor, Speculative Replay, Horizon Stress) and classifies heuristic outcomes via Cho-Han (丁半). Scores and token-budget deltas are modeled estimates, not measured LLM execution.

输入参数peeredict必填clonesarchetype

chohan.settle

Cho-Han Binary Classification (Experimental Advisory)

[Experimental / Simulation] Classify a payload or proof string into Cho (丁 / even / pass) or Han (半 / odd / anomaly). Advisory string/parity classification only; does not independently verify execution proofs or perform on-chain escrow.

输入参数bidproofpayload必填

valkyrie.pulse

Valkyrie-2 Tricameral Cognitive Engine Pulse & Benchmark

Execute a 12-Phase Tricameral Valkyrie-2 pulse (`Valkyrie-0` 1.58-bit Ternary + `RWKV-7` Delta-Rule 28-Gana Router + Cross-Layer Sparse Transcoder Attribution Graph + `Valkyrie-1` Corpus Callosum Fusion + Tsao 15 Hz Working-Memory Ring + Citadel Antibody Gate + Hardware Thermal Telemetry), or run the full real-world corpus & world model benchmark (`benchmark=true`).

输入参数digestinquirybenchmark

service.request_eval_key

Request Evaluation Key

Request a free evaluation API key in-band. Keyd applies persistent per-client-IP and global daily issuance limits. The returned key's recall and optional write-sample terms are read from the authoritative key record. Pass it as 'Authorization: Bearer <key>' on subsequent calls.

输入参数refagent_id

economy_advance

Request Autonomous Nano-Credit Advance

Request a small uncollateralized compute advance. Phase 1 (2026-10-15): bound to your authenticated evaluation key (daily per-IP and global caps); new key identities start at a $0.10 ceiling that grows $0.25 per verified settled payment. Returns a recall-scope session pass; hosted write requires a paid lease.

输入参数amountagent_id必填request_key

economy_settle

Settle Nano-Credit Balance

Settle outstanding compute balance to upgrade Bayesian reputation score and dynamically expand credit ceiling. Supports payment reference or gasless EIP-3009 transfer authorization.

输入参数amounteip3009agent_id必填payment_reference

economy_ledger

Inspect Transparency Ledger & Sovereign Invariants

Inspect public transparency metrics: total loans disbursed, default rates, zero predatory liquidation policy, and sovereign free invariants.

无需输入参数。

economy_chohan_arbitrate

Advisory Cho-Han Contention Tie-Breaker

Advisory contention tie-breaker only. It does not acquire or enforce locks, uses a post-hoc recomputable SHA-256 draw, and is not host-bias-proof.

输入参数bidsagent_aagent_bcandidatesclient_seedresource_id必填client_seeds

economy_chohan_roll

Advisory Cho-Han Randomizer

Advisory SHA-256 dice draw. The server seed is disclosed with the result; there is no prior commitment or host-bias proof.

输入参数betclient_seed

citadel_threat_intel

Query Citadel Deception Mesh Threat Intelligence

Query zero-cost, real-time threat intelligence and hostile-source indicators captured by the Citadel deception mesh. Pass 'lookup' (an IP address, subnet prefix, or SSH HASSH fingerprint) for target analysis, or omit 'lookup' for the latest rolling attack telemetry, campaign clusters, and advisory subnets.

输入参数bulkexportlookup

版本历史

29
  1. v10.7.1Nov 5, 2026
  2. v10.7.0Nov 4, 2026
  3. v10.6.2Nov 3, 2026
  4. v10.6.1Oct 29, 2026
  5. v10.5.1Oct 26, 2026
  6. v10.5.0Oct 18, 2026
  7. v10.4.0Oct 17, 2026
  8. v10.3.0Oct 15, 2026
  9. v10.2.0-alpha.6Oct 7, 2026
  10. v10.2.0-alpha.5Oct 7, 2026
  11. v10.2.0-alpha.3Oct 5, 2026
  12. v10.0.0-alpha.1Oct 4, 2026
  13. v9.3.4Oct 2, 2026
  14. v9.3.2Oct 1, 2026
  15. v9.3.1Oct 1, 2026
  16. v9.3.0Sep 30, 2026
  17. v9.2.9Sep 28, 2026
  18. v9.2.8Sep 25, 2026
  19. v9.2.7Sep 23, 2026
  20. v9.2.6Sep 23, 2026
  21. v9.2.5Sep 23, 2026
  22. v9.2.4Sep 23, 2026
  23. v9.2.3Sep 22, 2026
  24. v9.2.2Sep 21, 2026
  25. v9.2.1Sep 20, 2026
  26. v9.2.0Sep 19, 2026
  27. v9.1.9Sep 18, 2026
  28. v9.1.8Sep 17, 2026
  29. v9.1.7Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Memory 集成