MindSwap AI

Tu grabadora de caja negra para IA. Servidor CLI + MCP para transferencias de IA entre Claude Code, Cursor, Codex, Copilot y más.

Documentación

mindswap

npm version License: MIT

Mantén el contexto del proyecto y la memoria personal de IA local para que las herramientas puedan continuar el trabajo sin tener que reexplicar 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 continuar sin problemas.

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

Lo que te ofrece

  • init para configurar un repositorio e importar contexto de IA existente
  • save para capturar la tarea actual, el estado de git y las decisiones
  • doctor para verificar el estado de la configuración y el contexto obsoleto
  • resume para comenzar con un informe limpio
  • ask para buscar en la memoria del proyecto con citas
  • memory para gestionar bloqueos, suposiciones, preguntas y resoluciones
  • --global memoria y alcance de consulta para memoria personal entre herramientas bajo ~/.mindswap/
  • reindex para reconstruir el índice de búsqueda SQLite local desde 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 alcances de memoria local:

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

Usa la memoria global cuando una preferencia o aprendizaje deba seguirte entre 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 se encuentran en .mindswap/:

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

Paquete npm

Úsalo

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