toon-memoryDesenvolvido com TOON
A camada de continuidade para agentes de IA
O conhecimento do seu agente sobrevive a cada sessão — offline, privado, sem LLM.
$npm install -g toon-memory
Por que os agentes perdem contexto entre sessões?
Agentes de IA começam cada sessão com amnésia
Contexto reseta diariamente
A cada nova sessão, seu agente esquece as decisões, padrões e bugs que aprendeu ontem. Você reexplica o mesmo contexto repetidamente.
Caçando no histórico
Sem memória, os agentes fazem grep no histórico do git e relêem arquivos para reconstruir por que algo foi feito de certa forma — gastando tokens e tempo.
Notas de copiar e colar
Desenvolvedores colam contexto manualmente entre chats. É frágil, fica obsoleto e nunca chega à próxima execução autônoma.
toon-memory dá ao seu agente uma memória persistente e consultável — para que o contexto sobreviva a cada sessão, automaticamente.
Conheça o toon-memory
A camada de continuidade para seu fluxo de trabalho
Enquanto uma memória armazena fatos, uma camada de continuidade preserva como seu projeto funciona — para que cada sessão comece onde a anterior terminou.
Decisões
O "porquê" por trás de cada escolha — frameworks, bibliotecas, trade-offs. Lembrado quando importa, nunca re-litigado.
Convenções
Regras de nomenclatura, estrutura e estilo que seu time acordou. Seguidas sem precisar ser ditas de novo.
Contexto
Conhecimento de arquitetura, ambiente e operação que não vive em nenhum arquivo isolado.
Entendimento compartilhado
Conhecimento do projeto e decisões do time disponíveis para cada agente e cada sessão.
toon-memory introduz o conceito de camada de continuidade: um sistema leve que preserva conhecimento, decisões e contexto do projeto entre sessões de IA — sem serviços em nuvem nem infraestrutura pesada.
Por que os desenvolvedores escolhem o toon-memory
Privado, leve, universal
As garantias que tornam seguro manter a memória do projeto.
Privacidade em primeiro lugar
- 100% local — sem nuvem, sem servidor, sem telemetria
- Criptografia opcional AES-256-GCM
- Você é dono do arquivo de memória, como qualquer fonte
Leve
- Formato TOON nativo — 22% menos tokens que JSON
- ~1 MB instalado — uma única dependência runtime, roda em qualquer Node.js 18+
- Lógica determinística — sem chamadas LLM, sem chaves de API
Universal
- Funciona com 20+ agentes: Claude Code, Codex, Gemini CLI, Cursor, OpenCode e mais
- MCP padrão — troque de agente sem perder contexto
- Memória por projeto compartilhada por todo o time
Mesmo projeto. Duas sessões.
O que seu agente lembra muda o resultado.
Benchmarks
Medido, não assumido
Economia de tokens e chamadas medida em uma sessão real
menos tokens
menos chamadas
menos tokens
menos tokens
menos tokens
O formato TOON é feito para LLMs, não para humanos
JSON 1097→TOON 850
Medido com gpt-tokenizer (cl100k_base) em 16 entradas de memória representativas, comparando o formato TOON real em disco contra JSON compacto. Reproduzível: npm run bench.
Busca estilo LongMemEval sobre snapshot real congelado de 187 entradas — 42 gold queries
Snapshot real do data.toon (187 entradas, 2026-08-01), today determinístico, somente leitura e sem cópias; excluídas 2 meta-entradas priority. Reproduzível: npm run bench:retrieval.
Auto-loading: o plugin do OpenCode injeta apenas memória relevante ao arquivo em vez de despejar todas as entradas. Sessão completa: início → depuração → implementação → revisão → encerramento. Reprodutível: npm run bench:full, npm run bench:primer, npm run bench:compress-all.
Como funciona?
Quatro passos da amnésia à memória
Instalar
Um comando. Zero configuração para 20+ agentes.
npm install -g toon-memoryLembrar
Salve decisões, padrões e bugs enquanto trabalha — com inferência automática de tags e TTL opcional.
memory_remember({
category: "decision",
key: "use-zod",
content: "Use Zod for validation",
file: "src/types.ts"
})Recall
Seu agente consulta a memória sob demanda — sem reexplicar, sem desperdiçar tokens.
memory_recall({ query: "validation" })
// [decision] use-zod (a1b2c3d4)
// Use Zod for validation — src/types.tsContexto
Uma chamada dá ao seu agente tudo: projeto, git, memória, sessões. 80% menos chamadas de ferramenta.
context_generate({})
// # Project Briefing (full)
// ## Project — toon-memory v4.3.0
// ## Git — branch: main, 3 commits
// ## Memory — 26 entries, 18 edges
// ## Sessions — 2 activeUm kit de memória, não um protocolo
Tudo o que seu agente precisa para lembrar, recuperar e raciocinar — agrupado por propósito, com recursos para leitura direta de contexto e um visualizador de grafo interativo.
memory_remembermemory_recallmemory_forgetmemory_statsmemory_diffmemory_suggestmemory_summarymemory_archivememory_checkpointmemory_visualizememory_pinmemory_unpinmemory_tagmemory_reflectmemory_promotememory_smart_recallmemory_capturedmemory_consolidatememory_graph_pathmemory_searchcontext_briefcontext_generatecontext_diffcontext_focuscontext_healthcontext_exportmemory_compressmemory_primermemory_sessionsmemory_merge_sessionsmemory_export_gistmemory_import_gistmemory_encryptmemory_decryptmemory_backupmemory_secretmemory_export_globalmemory_import_globalMulti-agente
Funciona com todos os principais agentes de IA. OpenCode, VS Code, Claude, Cursor, Windsurf, Cline, Continue — zero configuração.
Formato TOON
22% menos tokens que JSON (medido). Codificação personalizada projetada para compreensão de LLMs e eficiência de tokens.
Recall inteligente
Recall baseado em grafo reordenado por relevância BM25 e centralidade do grafo (hubs aparecem mesmo sem a palavra de busca). Decaimento por hop mantém contexto distante baixo. Modo `compact` retorna resultados com índices numéricos e trechos.
Memória inteligente
Inferência automática de tags a partir de vocabulário integrado e dependências do projeto, pontuação de qualidade, escores de confiança, merge-dedup, sugestões de entradas relacionadas, diff de memória e TTL configurável para contexto temporário.
Criptografia
AES-256-GCM para dados sensíveis. Auto-arquivamento de entradas antigas. Modo watch para backup automático a cada N minutos.
Sua memória, como um grafo
Conecte decisões a suas specs, bugs e arquitetura. O recall retorna o contexto correto — não apenas correspondência de palavras.
- Vincule entradas com `links` ou referências `[[key]]` — sem embeddings, sem LLM
- `memory_recall({ mode: "graph" })` expande um subgrafo consciente de relações
memory_recall({ query: "riesgo", mode: "graph" })
[decision] risk-engine-priority (a1b2c3d4)
The engine prioritizes risk over speed.
File: spec.md:10 | Tags: risk;spec | Date: 2026-07-01
links: engine-archmemory_recall({ query: "riesgo", mode: "graph", compact: true })
[1] decision/risk-engine-priority
The engine prioritizes risk over speed.
tags: risk;spec · edges: ->2, ->3Visualizador do grafo de memória
Visualize sua memória como um grafo interativo de força dirigida. Veja entradas, conexões, categorias e padrões de acesso de relance.
- Visualizador CLI:
npx toon-memory viewerinicia um servidor HTTP - Visualizador inline MCP Apps: chame
memory_visualize()para renderizar o grafo diretamente em hosts compatíveis com MCP Apps — sem servidor - Passe o mouse sobre nós para tooltips com pré-visualização e pontuação de qualidade
- Clique para selecionar e centralizar; duplo clique para abrir detalhes
- A busca filtra entradas e destaca nós correspondentes com um brilho pulsante
- O localizador de caminhos encontra e destaca a conexão mais curta entre duas entradas
- Física ajustável, tema escuro/claro, exportação PNG/SVG
Um kit de memória
Tudo que seu agente precisa para lembrar, recuperar e raciocinar
Memória Principal
memory_rememberSalvar na memória
Armazena decisões, padrões, bugs, conhecimento ou warnings (memórias negativas "NÃO faça isso", recuperadas com impulso) — persistente entre sessões com pontuação de qualidade automática.
memory_recallBuscar memória
Consulta o grafo de conhecimento antes de ler arquivos. Resultados ponderados por qualidade. Suporta path scoping (path_scope) e controle de orçamento (tiny/normal/deep). explain: true anexa uma linha de motivo por entrada; budget_tokens limita a saída por tokens estimados.
memory_statsEstatísticas
Mostra estatísticas da memória do projeto, incluindo distribuição de qualidade, entradas mais acessadas e métricas de hit-rate/duplicatas/obsoletas.
Busca & Inteligência
memory_smart_recallRecall inteligente
Busca unificada combinando BM25 + centralidade + qualidade + frescor em uma chamada. Suporta explain: true (motivos por entrada) e budget_tokens (limite de saída).
memory_consolidateConsolidar
Mescla entradas duplicadas com conteúdo idêntico, detecta quase-duplicatas via similaridade Jaccard (>50%), remove entradas de baixa qualidade em lote ou aposenta entradas de versões antigas de bibliotecas (mode: "versions") — via parâmetro mode, sem LLM.
Briefing de Contexto
context_generateBriefing completo
Briefing em uma chamada: estrutura do projeto + estado git + memória + sessões. Substitui 6 chamadas manuais. Economiza 93% tokens.
context_healthAuditoria de saúde
Links órfãos, duplicatas, referências quebradas, TTL expirados, sessões obsoletas. Nota 0–100.
Compressão
memory_compressCompressão LLM
Compressão em duas etapas com LLM: resumir + sobrescrever. Usa Anthropic/OpenAI CLI se disponível.
memory_primerPrimer de contexto
Primer de contexto em uma chamada: memórias principais + categorias + alterações de arquivos da sessão. Injetado automaticamente no início da sessão.
Sessões
memory_sessionsSessões
Mostra sessões ativas do agente e detecta conflitos leves.
memory_merge_sessionsMesclar sessões
Mescla observações entre sessões paralelas para um arquivo. Deduplica e promove automaticamente.
Sincronização & Segurança
memory_encryptAtivar criptografia
Criptografia AES-256-GCM com chave auto-gerada.
memory_backupBackup da memória
Cria backup com timestamp do arquivo de memória. Auto-poduz para os 10 mais recentes.
memory-entriesmemory-statsmemory-summariesmemory-viewer (ui://viewer)Funciona com 20+ agentes de IA
Zero configuração — toon-memory detecta e configura cada um automaticamente
OpenCode
VS Code / Copilot
Claude
Cursor
Windsurf
Cline
Continue
Codex
Gemini
Zed
Antigravity
Aider
KiloCode
OpenClaw
Kiro
Qwen
Kimi
Goose
Junie
Amp
Grok
TraePerguntas frequentes
Tudo que você precisa saber para dar memória ao seu agente
O que é toon-memory?
Uma camada de memória persistente para agentes de IA com 35 ferramentas MCP. Armazena decisões, padrões, bugs e contexto em um formato TOON compacto para que seu agente lembre tudo entre sessões — com 80% menos chamadas de ferramenta por sessão.
Quais agentes são suportados?
OpenCode, VS Code, Claude Code, Cursor, Windsurf, Cline, Continue, Codex, Gemini, Zed, Antigravity, Aider, KiloCode, OpenClaw e Kiro — 20+ agentes com zero configuração via servidor MCP.
Como meus dados são armazenados?
Entradas são gravadas em um arquivo TOON local (um formato eficiente em tokens ~22% menor que JSON, medido). Você é dono do arquivo e pode commitar, diffar ou fazer backup como qualquer outro arquivo fonte.
Minha memória é criptografada?
Sim. Ative a criptografia com a ferramenta memory_encrypt para proteger entradas sensíveis com AES-256-GCM. A chave é gerada automaticamente e mantida local.
Funciona offline?
Completamente. toon-memory roda localmente sem serviços externos ou contas. O modo watch até cria backups automáticos em horário agendado.
Vários agentes podem compartilhar a mesma memória?
Sim. Como a memória vive em um arquivo simples no seu projeto, cada agente configurado para aquele projeto lê e escreve o mesmo contexto.
Como faço backup da minha memória?
Use o modo watch para backups automáticos agendados, ou simplesmente commite o arquivo TOON no git. Entradas antigas são auto-arquivadas após 30 dias para manter tudo limpo.
É gratuito e open source?
Sim. toon-memory é licenciado MIT e gratuito. O código está no GitHub e o pacote é publicado no npm.
Como isso difere da memória embutida do meu agente?
A memória embutida geralmente é efêmera ou específica do fornecedor. toon-memory dá a você um arquivo de memória portátil, com diff e criptografado que você controla totalmente entre agentes e projetos.
Posso expirar contexto temporário?
Sim. Defina um TTL (ex: ttl: "7d") em qualquer entrada e ela expira automaticamente — perfeito para sprints, prazos e notas sensíveis ao tempo.
O que é smart recall?
memory_smart_recall combina busca BM25 por palavras-chave, centralidade do grafo, pontuação de qualidade e decaimento de frescor em uma chamada — o melhor de todas as estratégias de ranking sem orquestração manual.
Como funciona a pontuação de qualidade?
Cada entrada recebe automaticamente uma pontuação de qualidade (0-1) baseada em cobertura de tags, riqueza de links, detalhe do conteúdo, frescor e especificidade. Entradas de alta qualidade aparecem primeiro nos resultados.
O que acontece se eu salvar a mesma chave duas vezes?
O sistema mescla atributos em vez de substituir: tags e links são unidos, qualidade e confiança tomam o máximo, e a data é atualizada. Sua entrada fica mais rica com o tempo.
O que é compressão de memória?
memory_compress permite que um LLM resuma entradas relacionadas em um resumo conciso. memory_consolidate(mode: "low-quality") remove entradas de baixa qualidade (sem tags, conteúdo curto) de forma determinística — sem LLM. Ambas reduzem a contagem de tokens.
Posso sincronizar a memória entre máquinas?
Sim. Use memory_export_gist para enviar entradas para um GitHub Gist, depois memory_import_gist em outra máquina. As entradas são mescladas automaticamente (união de tags, confiança máxima).
Pronto para dar continuidade ao seu agente?
Instale em segundos e nunca mais reexplique seu projeto.