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

Gajendra Malviya — Mon, 20 Apr 2026 08:32:10 +0000

Every time I switch from Claude Code to Cursor, or Copilot to Codex, the new AI starts from zero. Doesn't know my architecture. Doesn't know I chose JWT over sessions. Doesn't know I'm
halfway through the auth middleware.

I spend 20 minutes re-explaining. Every. Single. Time.

So I built mindswap — one command that captures your entire project state so any AI tool picks up instantly.

## How it works

  npx mindswap init    # once — auto-detects your stack
  npx mindswap         # when switching tools — that's it

When you run mindswap, it:

Auto-detects your task from the branch name (feat/user-auth → "user auth")
Captures git state — branch, diff, recent commits, changed files
Auto-logs dependency changes — added Stripe? Logged. Removed Redis? Logged.
Generates context files for 15 AI tools — CLAUDE.md, .cursor/rules, AGENTS.md, GEMINI.md, copilot-instructions, and more
Never overwrites your existing files — uses safe merge with markers
Scores your context quality (A-F) and tells you what's missing

## The killer feature: MCP Server

mindswap also runs as an MCP server with 3 tools:

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?"

One command configures it for Claude Code, Cursor, VS Code, Codex, and Gemini:

  npx mindswap mcp-install

## What makes it different

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

## The entire user flow

  npx mindswap init     # once
  npx mindswap          # when switching tools
  npx mindswap done     # when feature is complete

That's it. Everything else is automatic.

GitHub: github.com/ShipOrBleed/mindswap

npm: npm install mindswap --save-dev

Website: mindswap.vercel.app

DEV Community: Gajendra Malviya

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