mindswap

Mantén el contexto del proyecto y la memoria personal de la IA de forma local para que las herramientas puedan continuar el trabajo sin tener que volver a explicar el mismo contexto.

Por qué existe

Las sesiones de IA se reinician con demasiada frecuencia. mindswap guarda la tarea actual, las decisiones, los bloqueos y el contexto de traspaso para que la siguiente herramienta pueda retomar el trabajo limpiamente.

Instalación

npm install mindswap --save-dev

Inicio rápido

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

Qué te ofrece

• init para configurar un repositorio e importar el contexto de IA existente

• save para capturar la tarea actual, el estado de git y las decisiones

• doctor para comprobar el estado de la configuración y el contexto obsoleto

• resume para comenzar con un resumen limpio

• ask para buscar en la memoria del proyecto con citas

• memory para gestionar bloqueos, suposiciones, preguntas y resoluciones

• --global para el alcance de memoria y búsqueda personal para memoria entre herramientas bajo ~/.mindswap/

• reindex para reconstruir el índice de búsqueda local de SQLite a partir de tu memoria basada en archivos

• sync para compartir el estado de continuidad entre máquinas

• mcp y mcp-http para exponer el mismo contexto a clientes de IA

Memoria personal global

MindSwap ahora admite dos ámbitos de memoria local:

• memoria del repositorio en <repo>/.mindswap/

• memoria personal en ~/.mindswap/

Utiliza la memoria global cuando una preferencia o aprendizaje deba seguirte a través de proyectos y herramientas.

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 y herramientas de IA

mindswap genera contexto para herramientas como Claude Code, Cursor, Copilot, Codex, Windsurf, Cline, Roo, Aider, Amp, Gemini CLI y flujos de trabajo basados en AGENTS.md.

npx mindswap mcp-install
npx mindswap mcp-http

Estado del proyecto

Los datos principales del repositorio residen en .mindswap/:

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

Paquete npm

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

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

Úsalo

Si mindswap ayuda a tu flujo de trabajo, marca el repositorio con una estrella y sigue mejorando el ciclo de traspaso.