Mimir v2.0.0 — Phase 4: Platform

Mimir v2.0.0 — Phase 4: Platform

Theme: "Mimir as infrastructure." 12 months, 4 phases, 11 PRs, all shipped.

gRPC Transport

Full protobuf service definition with 28 RPCs mapping all MCP tools, plus streaming WatchJournal and StreamContext. Behind optional grpc feature flag.

Cryptographic Audit Log

Tamper-evident SHA-256 audit chain on journal entries. Each entry hashes the previous hash + event_id + timestamp. verify_audit_chain() walks the full journal and validates integrity.

Full Changelog (v1.0.1 → v2.0.0)

Phase 1 — Distribution & Ecosystem (v1.1.0): Integration guides, AutoGen adapter, --mcp-token auth, Docker CI, Windows CI, Glama TDQS 100%, decay batching, 100K stress test

Phase 2 — Multi-Agent & Federation (v1.2.0): workspace_hash scoping, agent_id attribution, vault federation, mimir_federate, mimir_share, visibility column, --workspace-token

Phase 3 — Offline Embeddings (v1.3.0): ONNX local embeddings with ort + tokenizers, LRU embedding cache, SIMD-accelerated dense search

Phase 4 — Platform (v2.0.0): gRPC transport (28 RPCs), cryptographic audit chain, streaming RPCs

Install

curl -sSL https://raw.githubusercontent.com/Perseus-Computing-LLC/mimir/main/scripts/bootstrap.sh | bash

Mimir v1.3.0 — Phase 3: Offline Embeddings

Mimir v1.3.0 — Phase 3: Offline Embeddings

Theme: "Truly zero-dependency semantic search." 10 merged PRs total across 3 phases, 35 MCP tools.

ONNX Local Embeddings

• bundled-embeddings feature (enabled by default) — ort + tokenizers + ndarray
• --embedding-model flag wires download of all-MiniLM-L6-v2 from HuggingFace on first use
• Full fallback chain: LRU cache → local ONNX → Ollama/remote → error
• Binary stays at 8.8 MB — model is lazy-downloaded, not bundled

Embedding Pipeline

• In-memory LRU embedding cache (256 entries, Mutex-protected)
• Incremental re-embedding (skips already-embedded entities)
• Background embedding available via cron-scheduled mimir_embed calls

SIMD-Accelerated Dense Search

• ndarray batched dot-product dense search (~10-50x faster at scale)
• Feature-gated: row-by-row fallback for builds without bundled-embeddings

Install

curl -sSL https://raw.githubusercontent.com/Perseus-Computing-LLC/mimir/main/scripts/bootstrap.sh | bash

Mimir v1.2.0 — Phase 2: Multi-Agent & Federation

Mimir v1.2.0 — Phase 2: Multi-Agent & Federation

Theme: "One memory engine, many agents, many workspaces." Q4 2026, 4 ships.

---

Workspace Scoping (#175)

workspace_hash column for multi-agent isolation. Agent A's memories invisible to Agent B. Scoped recall filter. Latent bug fixed: always_on/certainty were silently dropped on every recall (short SELECT lists).

Agent Identity (#176)

agent_id on entities + journal. Every entity tracks which agent wrote it. Context injection can filter by agent. Journal timeline shows agent attribution.

Cross-Workspace Federation (#177)

mimir_federate tool: export→remap workspace_hash→import between workspaces. Vault export now scopeable by workspace. .md frontmatter preserves workspace_hash + agent_id.

Access Controls (#178)

visibility column (private/workspace/public). mimir_share tool for sharing individual entities. --workspace-token CLI flag for cross-workspace auth. 33 MCP tools total.

---

By the numbers

• 4 PRs merged (Week 1-11)
• 5 new entity columns: workspace_hash, agent_id, visibility (+ journal equivalents)
• 2 new MCP tools: mimir_federate, mimir_share
• 33 total MCP tools (was 31 in v1.1.0)
• 31 passing Rust tests (+16 Python integration tests)
• 8.7 MB binary

Install

curl -sSL https://raw.githubusercontent.com/Perseus-Computing-LLC/mimir/main/scripts/bootstrap.sh | bash

Or download the binary from the assets below.

Mimir v1.1.0 — Phase 1: Distribution & Ecosystem

Mimir v1.1.0 — Phase 1: Distribution & Ecosystem

Theme: "Mimir everywhere." 12-week execution, 6 merged PRs.

Integration Guides (PR #169)

Polished Claude Code, Cursor, and General MCP guides: fixed version refs, broken cargo install instruction (crates.io name collision), wrong hybrid-search flags, and tool count.

Framework Adapters (PR #170)

• New: AutoGen (AG2 / autogen-core v0.4+) adapter — MimirMemory implementing the autogen_core.memory.Memory protocol
• Fixed crewai + langgraph init-handshake bug — 30s stall on every real session start (wrong JSON-RPC id)
• Fixed broken adapter tests — FakePopen used old communicate() API after adapters moved to persistent stdio
• New .github/workflows/integrations.yml — matrix-tests all three adapters

Transport & Docker (PR #171)

• --mcp-token Bearer auth — wired end-to-end for SSE/HTTP transport (was hardcoded None)
• 5 auth middleware tests — tower::oneshot router tests for 401/200/WWW-Authenticate
• docs/transport.md — SSE vs HTTP vs stdio, token auth, MCP Connector API wiring
• .github/workflows/docker.yml — GHCR image on main + tags (Alpine multi-stage)

Quality & Discovery (PR #172)

• Windows CI — test-windows job on every PR, green on first run
• Glama TDQS 100% — 31 tools, all with outputSchema + annotations (13 readOnlyHint, 18 destructiveHint)
• Smithery server.json — updated from v0.5.0 to v1.0.1

Stress Testing (PR #173)

• Decay batching — 1000-entity transaction chunks (O(1) WAL at any scale)
• 100K entity scale test — 0.028s FTS5 recall, 1.78s decay tick
• Concurrent r/w test — 0 errors in writer+reader sharing same SQLite WAL DB

Binary

mimir (8.7 MB, Linux x86-64, statically linked with musl)

Install

curl -sSL https://raw.githubusercontent.com/Perseus-Computing-LLC/mimir/main/scripts/bootstrap.sh | bash

Or download the binary from the assets below.

Mimir v1.0.1 — SSE Transport + Desktop Extension

Mimir v1.0.1 — Managed MCP Server

This release adds native SSE + Streamable HTTP transport, enabling Mimir to run as a remote MCP server reachable by Claude Desktop, Claude Code, and the Claude API.

New in v1.0.1

• SSE Transport (--transport sse): Server-Sent Events endpoint for remote MCP clients
• Streamable HTTP Transport (--transport http): Direct HTTP messaging for Claude API MCP Connector
• CORS support: Ready for browser-based MCP clients
• 30 MCP Tools: Full memory management (remember, recall, search, link, traverse, journal, cohere)

.mcpb Desktop Extension

This release includes mimir-1.0.1.mcpb — a one-click install package for Claude Desktop Extensions. Just download and double-click to give Claude persistent memory across conversations.

Quick Start

Remote MCP Server (no install required):

{
  "mcpServers": {
    "mimir": {
      "type": "url",
      "url": "https://mimir-mcp.perseus.observer/sse"
    }
  }
}

Claude API MCP Connector:

mcp_servers=[{
    "type": "url",
    "url": "https://mimir-mcp.perseus.observer/sse",
    "name": "mimir"
}]

Local Install (.mcpb):
Download mimir-1.0.1.mcpb below, double-click to install in Claude Desktop.

Built by Perseus Computing LLC | MIT License

Mimir v1.0.0

Mimir v1.0.0

MemoryMesh parity complete. Six major features from v0.5.0 to v1.0.0.

Features

• Hybrid search (#67) — Dense embeddings + FTS5 + Reciprocal Rank Fusion (k=60). Store f32 vectors as BLOBs, search via cosine similarity, fuse with keyword results.
• Query expansion (#68) — Porter stemming variants for FTS5 recall. Generate up to N stemmed alternatives, merge by highest-score dedup.
• External connectors (#69) — GitHub issues connector (REST API, rate-limit aware, paginated) + filesystem watcher (content-hash dedup). Triggered via mimir_ingest.
• RAG / ask_memory (#70) — mimir_ask tool: recall top-k entities, assemble context, query Ollama for grounded answers with cited sources.
• Encryption at rest (#71) — AES-256-GCM transparent encryption for entity body_json. Opt-in via --encryption-key. mimir keygen subcommand.
• Web dashboard (#72) — Axum HTTP server with self-contained dark-themed dashboard: search, stats, entity table, vis.js graph, timeline. mimir serve --web --port 8767.

New Tools (24 total)

mimir_ask, mimir_ingest (plus cosine_similarity and reciprocal_rank_fusion helper functions)

New CLI flags

--web, --port, --encryption-key, --llm-endpoint, --llm-model, --connectors-config, keygen subcommand, mode parameter on mimir_recall

Mimir v0.5.0 — 23 MCP tools, decay, vault, synthesis

Mimir v0.5.0 — 23 MCP tools, decay, vault, synthesis

What's new since v0.2.0

Decay & Layer Progression — Ebbinghaus-inspired memory decay model. Entities degrade over a 7-day half-life and are boosted on recall. Three-tier layer system: buffer → working → core, based on retrieval count thresholds (≥5, ≥20). New mimir_decay tool recalculates all scores.

Vault Export/Import — File-system vault for backup, transfer, and offline storage. mimir_vault_export writes entities + journal to markdown files under ~/.mimir/vault/. mimir_vault_import reads them back with idempotent upserts.

Chain Traversal — mimir_traverse walks the entity link graph up to a configurable depth, returning linked chains for knowledge graph exploration.

Entity Scoring — mimir_score assigns a numeric score (e.g. 0.0—1.0) to entities for ranking and prioritization.

Expanded Recall Output — mimir_recall now surfaces body_json fields (content, summary) as top-level keys on returned items, so downstream consumers like Perseus can render them directly.

CI Pipeline — GitHub Actions workflow for build + test on every push and PR to main.

Site Refresh — Benchmark page and landing site updated with decay + vault demos.

23 MCP tools

remember, recall, forget, link, unlink, journal, timeline, state_set, state_get, state_delete, state_list, health, stats, compact, migrate, context, workspace_list, workspace_set, decay, vault_export, vault_import, traverse, score

Binary

• mimir — Linux x86_64 static binary (3.8MB)
• Built from e2f4e13
• Rust 1.96.0

Upgrade

curl -sL https://github.com/tcconnally/mimir/releases/download/v0.5.0/mimir -o /usr/local/bin/mimir
chmod +x /usr/local/bin/mimir
# Schema auto-migrates on first run

Mneme v0.1.1

• Fixes #1: direct MCP server mode is now the documented/default invocation: mneme --db path.
• Adds deprecated top-level --mcp compatibility, so mneme --db path --mcp works.
• Keeps legacy mneme serve --db path --mcp compatibility.
• MCP serverInfo.version now comes from Cargo package metadata.
• Adds parser tests and JSON-RPC 2.0 request validation.

Verification:

• cargo fmt --check
• cargo clippy --all-targets -- -D warnings
• cargo test
• cargo build --release
• Direct optimized-binary MCP smoke returned serverInfo.version = 0.1.1.