Mindswap

Name: Mindswap
Author: ShipOrBleed

@ShipOrBleed

About Mindswap

Local-first AI context and memory server for cross-tool coding continuity. MindSwap helps coding agents and developers persist project context, search prior decisions, manage structured memory, resume work across sessions, and keep MCP-compatible tools aligned through one shared

#mcp #ai #coding-agent #developer-tools #context #memory #cli #productivity

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mindswap": {
      "command": "npx",
      "args": [
        "-y",
        "mindswap",
        "mcp"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Mindswap?

Mindswap is a local-first MCP server and CLI for persistent coding context across sessions. It helps developers and AI coding tools save project and task context, search previous work and decisions, manage structured memory, resume interrupted work, and share one continuity layer across MCP-compatible tools.

How to use Mindswap?

Install by adding a JSON configuration with npx -y mindswap mcp as the command and args in your MCP client’s mcpServers block. Use the MCP tools (mindswap_get_context, mindswap_save_context, mindswap_search, mindswap_memory) through the client, or run CLI commands directly (mindswap init, mindswap save, mindswap checkpoint, mindswap summary, mindswap resume, mindswap search, mindswap ask, mindswap memory, mindswap doctor, mindswap reindex).

Key features of Mindswap

Persistent coding context across sessions
Save and search project context and decisions
Manage structured memory (decisions, blockers, follow-ups)
Resume interrupted work seamlessly
Works locally with MCP-compatible tools

Use cases of Mindswap

Restore a coding session’s context after a break using mindswap resume
Search past decisions and blockers during a project
Keep a continuity layer shared across different AI coding tools
Track follow-ups and unanswered questions with mindswap memory

FAQ from Mindswap

How do I install Mindswap?

Add a JSON entry to your MCP client’s configuration: "mindswap": { "command": "npx", "args": ["-y", "mindswap", "mcp"] }.

What MCP tools does Mindswap include?

It provides mindswap_get_context, mindswap_save_context, mindswap_search, and mindswap_memory.

Is Mindswap cloud-based or local-first?

Mindswap is described as “local-first”, meaning data stays on your machine and sessions persists there.

How do I use the CLI part of Mindswap?

After installation, run commands like mindswap init, mindswap save, mindswap checkpoint, mindswap summary, mindswap resume, mindswap search, mindswap ask, mindswap memory, mindswap doctor, or mindswap reindex.