Skip to content
plugmcp
DirectorySkillsCategoriesBlog
EN/δΈ­ζ–‡
Sign inSign up
Home/Servers/Mindswap

Mindswap

I
by io.github.ShipOrBleed

Local-first AI context and memory server for cross-tool coding continuity.

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Local command
npx -y [email protected]
Provider
Claude Code
claude mcp add io.github.shiporbleed-mindswap -- npx -y [email protected]

Run in a terminal.

Claude Desktop
{
  "mcpServers": {
    "io.github.shiporbleed-mindswap": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ]
    }
  }
}

claude_desktop_config.json

Step-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Related MCP

View more
  • FirecrawlπŸ”₯ Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.
  • N
    NotionToken-auth Notion MCP: pages, databases, blocks, comments, files. Runs headless in CI and agents.
  • Context7Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors

Related skills

View all
  • reaReverse engineer anything with agents, from app behavior down to native binaries.
  • rea-changelog-updatePrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.
  • rea-tool-designDesign or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.

Questions

How do I install Mindswap?
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does Mindswap need an API key?
No required environment variable is listed on this record.
What transport does Mindswap use?
Mindswap runs locally over stdio.
When was Mindswap last checked?
Last checked 2026-10-16. Local-first AI context and memory server for cross-tool coding continuity.

Local-first AI context and memory server for cross-tool coding continuity.

mindswap

Keep project context and personal AI memory local so tools can continue work without re-explaining the same context.

Why it exists

AI sessions reset too often. mindswap saves the current task, decisions, blockers, and handoff context so the next tool can pick up cleanly.

Install

npm install mindswap --save-dev

Quick start

npx mindswap init
npx mindswap
npx mindswap doctor
npx mindswap resume
npx mindswap ask "Why did we choose JWT?"

What it gives you

  • init to set up a repo and import existing AI context
  • save to capture the current task, git state, and decisions
  • doctor to check setup health and stale context
  • resume to start with a clean briefing
  • ask to search project memory with citations
  • memory to manage blockers, assumptions, questions, and resolutions
  • --global memory and ask scope for personal cross-tool memory under ~/.mindswap/
  • reindex to rebuild the local SQLite search index from your file-based memory
  • sync to share continuity state across machines
  • mcp and mcp-http to expose the same context to AI clients

Global personal memory

MindSwap now supports two local memory scopes:

  • repo memory in <repo>/.mindswap/
  • personal memory in ~/.mindswap/

Use global memory when a preference or learning should follow you across projects and tools.

npx mindswap log "Prefer concise explanations" --type assumption --global
npx mindswap memory list --scope all
npx mindswap ask "What explanation style should we use?" --scope all
npx mindswap reindex --scope all

MCP and AI tools

mindswap generates context for tools like Claude Code, Cursor, Copilot, Codex, Windsurf, Cline, Roo, Aider, Amp, Gemini CLI, and AGENTS.md-based workflows.

npx mindswap mcp-install
npx mindswap mcp-http

Project state

The main repo data lives in .mindswap/:

.mindswap/
β”œβ”€β”€ HANDOFF.md
β”œβ”€β”€ state.json
β”œβ”€β”€ decisions.log
β”œβ”€β”€ memory.json
β”œβ”€β”€ config.json
β”œβ”€β”€ branches/
└── history/

npm package

  • npm: https://www.npmjs.com/package/mindswap
  • GitHub: https://github.com/ShipOrBleed/mindswap

Use it

If mindswap helps your workflow, star the repo and keep improving the handoff loop.

How do I install Mindswap?
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does Mindswap need an API key?
No required environment variable is listed on this record.
What transport does Mindswap use?
Mindswap runs locally over stdio.
When was Mindswap last checked?
Last checked 2026-10-16. Local-first AI context and memory server for cross-tool coding continuity.

No tool list yet. Remote servers get one after the first health check.

plugmcp

Plug any tool into any agent. MCP servers for people who do not write servers. Gateway for volume, n8n for apps.

  • github.com/TODO
  • x.com/TODO
  • linkedin.com/company/TODO

PlugMCP, 2026

Product
  • Browse
  • Install
  • Host your own
  • Pricing
  • Voice mode
  • Browser
Directory
  • All MCP servers
  • MCP Apps
  • Tools
  • Agent skills
  • Categories
  • New
  • Voice
  • Submit a server
Developers
  • Docs
  • Blog
  • Club
  • Work with us
  • What is MCP
  • What is WebMCP
  • Status
Company
  • About
  • Contact
  • Terms
  • Privacy
  • DPA