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 整合