v1.2.1  ·  MIT  ·  100% local — zero cloud

Your AI agents
finally remember.

One persistent, local memory shared by every AI coding agent — Antigravity, Cursor, Claude, OpenCode, Codex, Windsurf — through MCP. Decisions, conventions, bugfixes and session handoffs, always one recall away.

$ npx -y mindgate-mcp init Get started →

No account. No server. No network. Steal it, fork it, audit it.

10MCP tools
0network calls — ever
FTS5BM25 full-text recall
1SQLite file. chmod 600.
Works with every MCP client
AntigravityCursorClaude DesktopOpenCodeCodex CLIWindsurfCline

The problem

Every chat starts from zero.
And your keys keep leaking.

Session amnesia

Your agent re-derives the same architecture decisions, re-fixes the same class of bug, and re-litigates the same conventions — every single session.

Secret leakage into memory

Paste an error log with an API key into an agent and it lands in plain-text memory stores forever — unless it's redacted before it's written.

Locked to one tool

Copilot knows what Cursor doesn't. Your memory should outlive any single client — switching agents shouldn't mean starting from zero.

What you get

One local brain,
every agent plugged in.

⚡ FTS5 BM25 recall

SQLite's built-in full-text search ranks memories by relevance — architecture decisions, bugfixes, conventions — in microseconds, fully offline.

ZERO DEPENDENCIES

🔁 Cross-agent handoffs

End a session in Antigravity, resume in Cursor. Structured session summaries, next steps and active files travel with the repo's memory.

log_session_summary

🧬 Auto-compiled AGENTS.md

Stored decisions, conventions and bugfixes compile into the rules file every major agent reads natively. Atomic writes, timestamped .bak backups, hand-written files never overwritten without force: true.

sync_workspace_rules

🔒 Secret redaction on write

OpenAI, GitHub, AWS, Slack, Google keys, JWTs and PEM blocks are masked with [REDACTED:kind] before anything touches disk. Tools report how many were caught.

MINDGATE_REDACT_SECRETS

🛡️ Node2Shell guard

Mitigations for CVE-2026-111497: stdio-only transport, runtime version enforcement, and a Brotli decompression hard-lock installed before any other module loads.

CVE-2026-111497

✏️ In-place updates & snapshots

Decisions evolve — memory does too. Update records without losing their ID or timestamp, export portable JSON snapshots, keep FTS5 in sync automatically.

update_memory · export_memory_snapshot

Architecture

Six layers,
zero surprises.

Every tool call flows through the same pipe. No hidden network, no implicit writes, no silent overwrites.

⚠️ Honest limits: memories are data, not instructions · redaction is best-effort pattern matching · the Brotli lock is defense-in-depth — a patched runtime is the definitive fix. Full threat model in SECURITY.md.

MCP Tools

Ten tools,
no ceremony.

Install

Thirty seconds
to a smarter agent.

# requires Node 22.23.4+ / 24.22.1+ / 26.12.1+
npm install -g mindgate-mcp

# or zero-install
npx -y mindgate-mcp init   # prints ready-to-paste MCP config
# Windows / macOS / Linux
git clone https://github.com/aaserag1/mindgate-mcp.git
cd mindgate-mcp
npm install
npm test          # 29 tests — real SQLite + FTS5
npm run build
npm run init-config
{
  "mcpServers": {
    "mindgate": {
      "command": "node",
      "args": ["/absolute/path/to/mindgate-mcp/dist/index.js"],
      "env": { "MINDGATE_DB_PATH": "/home/you/.mindgate/mindgate.db" }
    }
  }
}

FAQ

Fair questions.
Straight answers.

Does my code or memory leave my machine?

No. MindGate has no network code at all — it speaks stdio JSON-RPC to your agent and SQLite to your disk. The only way data leaves is if you paste it into an agent that sends it to a model API, same as always.

What happens if I paste an API key into a memory?

Known token shapes (OpenAI, GitHub, AWS, Slack, Google, JWT, PEM) are replaced with [REDACTED:kind] before anything is written, and the tool response tells you how many were caught. It's a strong safety net, not a guarantee — keep secrets out of prompts entirely.

Will sync_workspace_rules overwrite my hand-written AGENTS.md?

Never silently. MindGate-generated files carry an HTML sentinel marker; hand-written files are refused unless you explicitly pass force: true — and a timestamped .bak backup is always created first. Writes are atomic (temp file + rename).

Which agents work with it?

Anything that speaks MCP over stdio with tool support: Antigravity, Cursor, Claude Desktop, OpenCode, Codex CLI, Windsurf, Cline. If it launches an MCP server, MindGate plugs in.

How do I uninstall?

Remove the MCP server entry from your client config, then delete ~/.mindgate/. That's it — one directory, one config block. No daemon, no registry, no residue.

MindGate — an Egyptian gate fused with glowing circuitry, the symbol of بوابة العقل

Your next session
shouldn't start from zero.

Free, open-source, MIT licensed. Audit every line — that's the point of local.

Star on GitHub →