¿Qué puedes hacer con Mindswap?

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.

Instalación

Añade Mindswap a tu cliente. Elige el que uses.

claude mcp add mindswap -- npx -y mindswap

codex mcp add mindswap -- npx -y mindswap

amp mcp add mindswap -- npx -y mindswap

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

Add to `claude_desktop_config.json`, then restart Claude Desktop.

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

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

code --add-mcp '{"name":"mindswap","command":"npx","args":["-y","mindswap"]}'

Or add the block manually to `.vscode/mcp.json` under `servers`.

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

Add to `~/.codeium/windsurf/mcp_config.json`.

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

Add to `cline_mcp_settings.json` via the MCP Servers panel.

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

Add to `~/.gemini/settings.json`.

{
  "mcpServers": {
    "mindswap": {
      "type": "local",
      "command": "npx",
      "args": [
        "-y",
        "mindswap"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.

{
  "context_servers": {
    "mindswap": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mindswap"
        ]
      }
    }
  }
}

Add to your Zed `settings.json`.

npx -y mindswap

Run `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.

Puntuación

39 / 100

Incompleta

Documentación22/25
Mantenimiento13/25
Confianza16/20
Capacidad0/15
Instalación12/15

Documents what it does and how to connect
Has a resolvable package or endpoint
Exposes at least one tool, prompt or resource
README has substantive content
Includes a code example
Documents its configuration
Mentions credentials or security posture
Last commit 120 days ago
Has a release history
Repository is not archived
Licensed MIT
Namespace verified in the official MCP registry
Claimed by its owner
Published under an organisation
0 tool(s) documented
Provides prompt templates
Provides resources
12 documented install method(s)
Published to a package registry
Offers a hosted endpoint — no local install

Leer los criterios completos →

Historial de versiones

Versiones	Publicada
3.3.0Última	3 may 2026
3.2.3	1 may 2026