Mindswap
@ShipOrBleed
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
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.
Where can I find more about Mindswap?
The GitHub repository is at https://github.com/ShipOrBleed/mindswap, and the package is on npm at https://www.npmjs.com/package/mindswap.
