나는 매번 AI에게 내 프로젝트를 다시 설명하는 것이 지겨워서 도구를 만들었다

Source: Dev.to

작동 방식

# 한 번 실행해 스택을 자동 감지
npx mindswap init

# 도구를 전환할 때마다 이 명령 실행
npx mindswap

mindswap을 실행하면:

• 브랜치 이름에서 작업을 자동 감지 (예: feat/user-auth → “user auth”)
• Git 상태 캡처 – 현재 브랜치, diff, 최근 커밋, 변경 파일
• 의존성 변경을 자동 로그 (예: “added Stripe”, “removed Redis”)
• 15개의 AI 도구용 컨텍스트 파일 생성 (CLAUDE.md, .cursor/rules, AGENTS.md, GEMINI.md, copilot-instructions 등)
• 기존 파일을 절대 덮어쓰지 않음 – 마커가 있는 안전한 병합 사용
• 컨텍스트 품질을 점수화 (A‑F)하고 누락된 부분을 알려줌

핵심 기능: MCP 서버

mindswap은 세 개의 엔드포인트를 가진 MCP (Multi‑Context Provider) 서버로도 실행될 수 있습니다:

다음 명령 하나로 Claude Code, Cursor, VS Code, Codex, Gemini 등 여러 도구에 대한 서버를 설정합니다:

npx mindswap mcp-install

차별점

• 수동 입력 전혀 없음 – 모든 것이 Git에서 자동 감지
• 결정 충돌 감지 – 자신과 모순되는 내용이 있으면 경고 (예: “NOT using Redis” 뒤에 “using Redis”)
• 브랜치‑별 상태 – 각 Git 브랜치마다 고유한 작업과 결정 보유
• 시크릿 스캔 – 컨텍스트 파일을 쓰기 전에 API 키 등 비밀 정보를 검사
• 30개 이상의 프레임워크 감지 – Next.js, Go, Python, Rust, Rails, Spring Boot 등

전체 사용자 흐름

npx mindswap init   # 한 번, 설정
npx mindswap        # AI 도구를 전환할 때마다
npx mindswap done   # 기능이 완료됐을 때

그게 전부 – 나머지는 자동으로 처리됩니다.

링크

• GitHub:
• npm: npm install mindswap --save-dev
• 웹사이트: