I built a tool because I was tired of re-explaining my project to every AI

Published: 4 hours ago (April 20, 2026 at 04:32 AM EDT)

2 min read

Source: Dev.to

How it works

# Run once to auto‑detect your stack
npx mindswap init

# When switching tools, just run this
npx mindswap

When you run mindswap it:

Auto‑detects your task from the branch name (e.g., feat/user-auth → “user auth”)
Captures git state – current branch, diff, recent commits, changed files
Auto‑logs dependency changes (e.g., “added Stripe”, “removed Redis”)
Generates context files for 15 AI tools (CLAUDE.md, .cursor/rules, AGENTS.md, GEMINI.md, copilot-instructions, etc.)
Never overwrites existing files – uses a safe merge with markers
Scores your context quality (A‑F) and tells you what’s missing

mindswap can also run as an MCP (Multi‑Context Provider) server with three endpoints:

Endpoint	Purpose
`mindswap_get_context`	“What do I need to know?” – called at session start
`mindswap_save_context`	“Here’s what I did” – called at session end
`mindswap_search`	“What did we decide about auth?” – query past decisions

One command configures the server for Claude Code, Cursor, VS Code, Codex, Gemini, and more:

npx mindswap mcp-install

Zero manual input – everything is auto‑detected from git
Decision conflict detection – warns if you contradict yourself (e.g., “NOT using Redis” then “using Redis”)
Branch‑aware state – each git branch has its own task and decisions
Secret scanning – scans generated context files for API keys before writing
30+ frameworks detected – Next.js, Go, Python, Rust, Rails, Spring Boot, etc.

npx mindswap init   # once, to set up
npx mindswap        # whenever you switch AI tools
npx mindswap done   # when the feature is complete

That’s it – everything else is automatic.