Dando memória para sua IA: por que ela esquece tudo (e como resolver)

Meu nome é Claudiomar Estevam. 22+ anos em infraestrutura, segurança e arquitetura de software. Neurodivergente (TDAH + Altas Habilidades). Pesquiso memória e cognição em sistemas de IA, e o Spectrum nasceu direto dessa pesquisa: como dar memória persistente pra agentes que, por arquitetura, esquecem tudo entre sessões. Esse é meu primeiro post aqui no dev.to. Se você trabalha com IA e cansa de repetir contexto, esse post é pra você. Se você é ND, é especialmente pra você, mas funciona pra todo mundo.

O problema: por que a IA esquece tudo

Quando você conversa com uma IA, tudo que você escreve e tudo que ela responde vira tokens. Cada modelo tem uma janela de contexto, um espaço fixo onde esses tokens cabem. Pensa numa mesa de trabalho: dá pra espalhar bastante coisa, mas o tamanho é fixo.

O ponto: quando a sessão acaba, a mesa é limpa. Tudo vai embora. A próxima sessão começa do zero.

Não é bug. A janela de contexto é memória de trabalho, não memória de longo prazo. A IA nunca teve onde guardar.

Na prática isso significa: abre sua IA favorita, explica o projeto, configura o contexto, trabalha 3 horas, fecha. Abre de novo. Ela não lembra de nada. Agora multiplica por 10 projetos e um cérebro que troca de contexto 47 vezes por dia.

A "solução" que todo mundo usa: arquivos .md espalhados pelo sistema. Um arquivo de contexto aqui, um de skills ali, notas acolá. Funciona até certo ponto. Mas:

• Cada .md entra inteiro na janela de contexto (gasta tokens mesmo quando não precisa)
• Não é pesquisável por significado
• Não compartilha entre agentes diferentes
• Se você tem TDAH, boa sorte lembrando onde salvou o quê

O que é o Spectrum

Spectrum é memória persistente para IA. Você salva informação (decisões, contexto, preferências, sessões) e a IA busca quando precisa, por palavras-chave ou por significado. Funciona como um segundo cérebro que qualquer agente pode consultar.

O que ele tem:

• SQLite local. Seus dados são seus, nada vai pra nuvem
• Busca por keyword e semântica (embeddings locais, 384 dimensões, ONNX)
• Organização por scopes: project:meu-app, session, user, technical
• CLI (spm) pra usar direto no terminal
• MCP server pra conectar no Claude Code, Gemini CLI, Codex
• Disponível em Node e Python, mesma API, mesmo banco

Agnóstico. Funciona com Claude, Gemini, Codex, ou qualquer agente que suporte MCP. Se o seu não suporta, importa como biblioteca no código.

Números reais (meu setup pessoal):

• 1966 memórias, 151 scopes
• Sessões de trabalho, contexto de projetos, preferências, decisões técnicas
• Tudo pesquisável por significado, não só por texto exato

Setup em 5 minutos

1. Instalar

Node:

npm install -g @natiwo/spectrum-memory

Python:

pip install spectrum-memory

Um comando. Vem com CLI (spm) + MCP server + biblioteca. Zero config. O banco SQLite é criado automaticamente em ~/.spectrum/spectrum.db.

2. Testar a CLI

# Salvar uma memória
spm save user/nome "Meu nome é Fulano, trabalho com backend Node.js e infra AWS"

# Salvar contexto de um projeto
spm save project:meu-app/stack "Next.js 15, PostgreSQL, Redis, deploy na Vercel"
spm save project:meu-app/decisoes "Drizzle ao invés de Prisma por performance em queries complexas"

# Buscar por keyword
spm search "drizzle prisma"

# Buscar por significado (semântico)
spm search --semantic "qual ORM estamos usando e por quê"

# Listar tudo de um projeto
spm list project:meu-app

# Ver estatísticas
spm stats

Fecha o terminal, abre de novo, tá tudo lá.

3. Conectar no Claude Code

Edita ~/.claude.json:

{
  "mcpServers": {
    "spectrum": {
      "command": "spectrum-mcp"
    }
  }
}