# Mindswap

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

- **Type:** MCP server
- **Install:** `agentstack add mcp-shiporbleed-mindswap`
- **Verified:** Pending review
- **Seller:** [ShipOrBleed](https://agentstack.voostack.com/s/shiporbleed)
- **Installs:** 0
- **Latest version:** 3.2.3
- **License:** MIT
- **Upstream author:** [ShipOrBleed](https://github.com/ShipOrBleed)
- **Source:** https://github.com/ShipOrBleed/mindswap
- **Website:** https://mindswap.vercel.app

## Install

```sh
agentstack add mcp-shiporbleed-mindswap
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# mindswap

[](https://www.npmjs.com/package/mindswap)
[](https://opensource.org/licenses/MIT)

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

```bash
npm install mindswap --save-dev
```

## Quick start

```bash
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 `/.mindswap/`
- personal memory in `~/.mindswap/`

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

```bash
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.

```bash
npx mindswap mcp-install
npx mindswap mcp-http
```

## Project state

The main repo data lives in `.mindswap/`:

```text
.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.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ShipOrBleed](https://github.com/ShipOrBleed)
- **Source:** [ShipOrBleed/mindswap](https://github.com/ShipOrBleed/mindswap)
- **License:** MIT
- **Homepage:** https://mindswap.vercel.app

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Versions

- **3.2.3** — security scan: pending review — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-shiporbleed-mindswap
- Seller: https://agentstack.voostack.com/s/shiporbleed
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.