AgentStack
Browse Sign in
Browse Why AgentStack Sell Docs
Sign in
MCP verified MIT Self-run

Mindswap

mcp-shiporbleed-mindswap · by ShipOrBleed

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

↗ Website ↗ Repository
— No reviews yet
0 installs
38 views
0.0% view→install

Install

$ agentstack add mcp-shiporbleed-mindswap

✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v3.2.3 How review works →

  • ✓ Prompt-injection patterns
  • ✓ Secret / credential exfiltration
  • ✓ Dangerous shell & filesystem operations
  • ✓ Untrusted network calls
  • ✓ Known-malicious package signatures

What it can access

  • ✓ Network access No
  • ✓ Filesystem access No
  • ✓ Shell / process execution No
  • ✓ Environment & secrets No
  • ✓ Dynamic code execution No

From automated source analysis of v3.2.3. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

View the full security report →

Verified badge

Passed review? Show it. Paste this badge into your README, it links to the public security report.

AgentStack Verified badge Links to your public security report.
[![AgentStack Verified](https://agentstack.voostack.com/badges/verified.svg)](https://agentstack.voostack.com/security/report/mcp-shiporbleed-mindswap)

Reliability & compatibility

✓ Security review passed
0 installs to date
— no reviews yet
○ 4mo ago

Declared compatibility

Claude CodeClaude DesktopCursorWindsurf

Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.

Preview Execution monitoring

We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.

How agent discovery & health will work →
Are you the author of Mindswap? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

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

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

  • 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.

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

  • 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.

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

Reviews

No reviews yet, be the first.

Write a review

Versions

  • v3.2.3 Imported from the upstream source.

More in Integrations