MindSwap AI

Seu gravador de caixa preta de IA. Servidor CLI + MCP para transferências de IA entre Claude Code, Cursor, Codex, Copilot e outros.

GitHub
7
Experimente este MCPPatrocinado

Documentação

mindswap

npm version License: MIT

Mantenha o contexto do projeto e a memória pessoal de IA localmente para que as ferramentas possam continuar o trabalho sem reexplicar o mesmo contexto.

Por que existe

As sessões de IA são reiniciadas com muita frequência. O mindswap salva a tarefa atual, decisões, bloqueios e contexto de transferência para que a próxima ferramenta possa continuar de forma limpa.

Instalação

npm install mindswap --save-dev

Início rápido

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

O que ele oferece

  • init para configurar um repositório e importar contexto de IA existente
  • save para capturar a tarefa atual, estado do git e decisões
  • doctor para verificar a saúde da configuração e contexto desatualizado
  • resume para começar com um briefing limpo
  • ask para pesquisar a memória do projeto com citações
  • memory para gerenciar bloqueios, suposições, perguntas e resoluções
  • --global memória e escopo de consulta para memória pessoal entre ferramentas sob ~/.mindswap/
  • reindex para reconstruir o índice de busca SQLite local a partir da sua memória baseada em arquivos
  • sync para compartilhar o estado de continuidade entre máquinas
  • mcp e mcp-http para expor o mesmo contexto a clientes de IA

Memória pessoal global

O MindSwap agora suporta dois escopos de memória local:

  • memória do repositório em <repo>/.mindswap/
  • memória pessoal em ~/.mindswap/

Use a memória global quando uma preferência ou aprendizado deve acompanhar você entre projetos e ferramentas.

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 e ferramentas de IA

O mindswap gera contexto para ferramentas como Claude Code, Cursor, Copilot, Codex, Windsurf, Cline, Roo, Aider, Amp, Gemini CLI e fluxos de trabalho baseados em AGENTS.md.

npx mindswap mcp-install
npx mindswap mcp-http

Estado do projeto

Os dados principais do repositório ficam em .mindswap/:

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

Pacote npm

Use

Se o mindswap ajudar no seu fluxo de trabalho, dê uma estrela no repositório e continue melhorando o ciclo de transferência.