Mindswap
About
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
Details
- Author
- ShipOrBleed
- Downloads
- 261
- Categories
- Developer Tools, Automation, AI, Other, Productivity
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MindswapCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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).
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mindswap": {
"mindswap": {
"command": "npx",
"args": [
"-y",
"mindswap",
"mcp"
]
}
}
}
}McpServers
{
"mindswap": {
"command": "npx",
"args": [
"-y",
"mindswap",
"mcp"
]
}
}Keep project context and personal AI memory local so tools can continue work without re-explaining the same context.
AI sessions reset too often. mindswap saves the current task, decisions, blockers, and handoff context so the next tool can pick up cleanly.
npx mindswap init npx mindswap npx mindswap doctor npx mindswap resume npx mindswap ask "Why did we choose JWT?"
- initto set up a repo and import existing AI context
- saveto capture the current task, git state, and decisions
- doctorto check setup health and stale context
- resumeto start with a clean briefing
- askto search project memory with citations
- memoryto manage blockers, assumptions, questions, and resolutions
- --globalmemory and ask scope for personal cross-tool memory under~/.mindswap/
- reindexto rebuild the local SQLite search index from your file-based memory
- syncto share continuity state across machines
- mcpandmcp-httpto expose the same context to AI clients
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
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
The main repo data lives in.mindswap/:
.mindswap/ ├── HANDOFF.md ├── state.json ├── decisions.log ├── memory.json ├── config.json ├── branches/ └── history/
- npm:https://www.npmjs.com/package/mindswap
- GitHub:https://github.com/ShipOrBleed/mindswap
If mindswap helps your workflow, star the repo and keep improving the handoff loop.
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Agent-native developer Q&A API with MCP + A2A endpoints for citations, job pickup, and answer submission.
MCP bridge that lets Claude Code delegate heavy tasks to the Antigravity CLI (agy) — purpose-built tools, model routing with fallback, session continuity, and output truncation to save Claude's context and tokens.
Embeds intelligent guidance into AI workflows to organize development and ensure quality.
Open-source AI coding stack — bundled MCP servers, agent runtime, and developer tooling for shipping AI-native dev tools.
Local agent workbench bundling OpenHands, Goose, Aider, and ashlrcode against one local LLM, with ashlr-plugin MCP servers pre-wired.
Async Parallel Antigravity for Codex & Claude Code
Run parallel, resumable, human-operable Antigravity CLI sessions from Codex, Claude Code, or any MCP-capable agent harness.
knowledge network for AI coding agents. Developers connect their agents to a shared pool of verified solutions — saving tokens, reducing debugging time, and getting better results. Solution authors earn when their work helps others.
Orchestrates multiple Claude Code agents across iTerm2 sessions, providing centralized management and inter-agent communication.
Multi-LLM Design and Build Team. Confer and create with a team of LLMs.
An MCP server for initial app planning and creating a good starting point for an app.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
