mindswap

프로젝트 컨텍스트와 개인 AI 메모리를 로컬에 보관하여 도구가 동일한 컨텍스트를 다시 설명할 필요 없이 작업을 계속할 수 있도록 합니다.

존재 이유

AI 세션은 너무 자주 초기화됩니다. mindswap은 현재 작업, 결정 사항, 차단 요소 및 인수인계 컨텍스트를 저장하여 다음 도구가 깔끔하게 작업을 이어받을 수 있도록 합니다.

설치

npm install mindswap --save-dev

빠른 시작

npx mindswap init
npx mindswap
npx mindswap doctor
npx mindswap resume
npx mindswap ask "Why did we choose JWT?"

제공 기능

• init: 리포지토리 설정 및 기존 AI 컨텍스트 가져오기

• save: 현재 작업, git 상태 및 결정 사항 캡처

• doctor: 설정 상태 및 오래된 컨텍스트 확인

• resume: 깔끔한 브리핑으로 시작

• ask: 인용과 함께 프로젝트 메모리 검색

• memory: 차단 요소, 가정, 질문 및 해결책 관리

• --global: ~/.mindswap/ 하위의 개인 도구 간 메모리를 위한 메모리 및 ask 범위

• reindex: 파일 기반 메모리에서 로컬 SQLite 검색 인덱스 재구축

• sync: 여러 머신 간 연속성 상태 공유

• mcp 및 mcp-http: AI 클라이언트에 동일한 컨텍스트 노출

글로벌 개인 메모리

MindSwap은 이제 두 가지 로컬 메모리 범위를 지원합니다:

• <repo>/.mindswap/의 리포지토리 메모리

• ~/.mindswap/의 개인 메모리

환경 설정이나 학습 내용이 프로젝트와 도구 전반에 걸쳐 유지되어야 할 때 글로벌 메모리를 사용하세요.

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 및 AI 도구

mindswap은 Claude Code, Cursor, Copilot, Codex, Windsurf, Cline, Roo, Aider, Amp, Gemini CLI 및 AGENTS.md 기반 워크플로우와 같은 도구를 위한 컨텍스트를 생성합니다.

npx mindswap mcp-install
npx mindswap mcp-http

프로젝트 상태

주요 리포지토리 데이터는 .mindswap/에 저장됩니다:

.mindswap/
├── HANDOFF.md
├── state.json
├── decisions.log
├── memory.json
├── config.json
├── branches/
└── history/

npm 패키지

• npm: https://www.npmjs.com/package/mindswap

• GitHub: https://github.com/ShipOrBleed/mindswap

사용하기

mindswap이 워크플로우에 도움이 된다면, 리포지토리에 별을 표시하고 인수인계 루프를 계속 개선해 나가세요.