DEV Community

Cover image for I built a tool because I was tired of re-explaining my project to every AI
Gajendra Malviya
Gajendra Malviya

Posted on

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

#ai #opensource #productivity #webdev

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
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

## 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
Enter fullscreen mode Exit fullscreen mode

That's it. Everything else is automatic.

GitHub: github.com/ShipOrBleed/mindswap

npm: npm install mindswap --save-dev

Website: mindswap.vercel.app

Top comments (0)