Summary
This server keeps your AI coding context alive between sessions so you don't spend half your time re-explaining decisions. It exposes tools to save current task state, resume work with a briefing, query past decisions with citations, and log blockers or assumptions. Memory lives in `.mindswap/` as markdown and JSON, indexed in SQLite for semantic search. You can scope it per-repo or globally in your home directory. Includes `mindswap init`, `save`, `resume`, `ask`, and `memory` commands, plus MCP endpoints via stdio or HTTP. Reach for it when you're hopping between Cursor, Claude, and Windsurf on the same project and tired of copy-pasting the same context doc every morning.
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →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
initto set up a repo and import existing AI contextsaveto capture the current task, git state, and decisionsdoctorto check setup health and stale contextresumeto start with a clean briefingaskto search project memory with citationsmemoryto 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 memorysyncto share continuity state across machinesmcpandmcp-httpto 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
Use it
If mindswap helps your workflow, star the repo and keep improving the handoff loop.
Featured
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
