Mindswap
Local-first AI context and memory server for cross-tool coding continuity.
Open source Open in the app JSON README (API)
About
Local-first AI context and memory server for cross-tool coding continuity.
Details
- Kind
- MCP servers
- Topic
- AI, RAG & memory
- Publisher
- shiporbleed
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 3.3.0
- Stars
- 7
- Last push
- 2026-05-03T17:09:38Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 03:02:15
- Updated
- 2026-08-29 03:02:15
- Origin id
io.github.ShipOrBleed/mindswap
README
# 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 `<repo>/.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.