Memgentic

Memgentic — Camada Universal de Memória para IA

O Memgentic captura conhecimento de todas as suas ferramentas de IA e o torna pesquisável. Cada memória carrega proveniência completa: qual ferramenta, qual sessão, quando ocorreu.

Quando Usar

Pesquise na memória antes de começar a trabalhar, não depois:

• Iniciando uma nova tarefa — Verifique decisões anteriores, contexto ou trabalho relacionado.
• Tomando decisões de arquitetura — Verifique se isso já foi discutido antes.
• Depurando — Pesquise por problemas e soluções passadas relacionadas.
• Usuário pergunta sobre histórico — "o que decidimos sobre...", "lembra quando...", "como lidamos com..."
• Encontrando código desconhecido — Verifique o contexto de por que foi escrito daquela forma.
• Configurando algo — Verifique preferências e convenções do usuário.

Em caso de dúvida, pesquise. Custa pouco e evita trabalho repetido.

Comandos CLI

Busca Semântica (principal)

# Buscar memórias pelo significado
memgentic search "estratégia de migração de banco de dados"

# Saída compacta — menos tokens, ideal para escaneamento
memgentic search "estratégia de migração de banco de dados" --format compact

# Filtrar por plataforma
memgentic search "implementação de autenticação" -s claude_code
memgentic search "design de API" -s chatgpt

# Filtrar por tipo de conteúdo
memgentic search "por que escolhemos PostgreSQL" -t decision
memgentic search "estilo de codificação do usuário" -t preference

Armazenar uma Memória

# Salvar um fato ou decisão importante
memgentic remember "Escolhemos Qdrant em vez de Pinecone para armazenamento vetorial local-first"

# O tipo de memória é classificado automaticamente a partir do conteúdo
memgentic remember "Sempre use UV para gerenciamento de pacotes"

Outros Comandos

# Ver quais plataformas têm memórias e quantas
memgentic sources

# Gerar arquivo de contexto autônomo com atividade recente
memgentic update-context

# Explorar grafo de conhecimento em torno de uma entidade
memgentic graph "autenticação"

# Verificar saúde do sistema
memgentic doctor

Ferramentas MCP

Se o servidor MCP do Memgentic estiver em execução, estas ferramentas estarão disponíveis diretamente:

Ferramenta	Propósito
memgentic_recall	Busca semântica com filtragem por fonte
memgentic_remember	Armazenar uma nova memória
memgentic_search	Busca por palavra-chave em texto completo
memgentic_recent	Memórias recentes por carimbo de data/hora
memgentic_briefing	Briefing entre agentes sobre atividade recente
memgentic_sources	Listar plataformas e contagens de memórias
memgentic_configure_session	Definir filtros de fonte no nível da sessão
memgentic_stats	Estatísticas e análises de memória
memgentic_forget	Arquivar (exclusão suave) uma memória
memgentic_export	Exportar memórias como JSON

Exemplos MCP

memgentic_recall(query="fluxo de autenticação", limit=5)
memgentic_recall(query="auth", sources=["claude_code", "chatgpt"])
memgentic_remember(content="O projeto usa JWT com refresh tokens", memory_type="decision")
memgentic_search(query="PostgreSQL", content_type="decision")
memgentic_configure_session(exclude_sources=["codex_cli"])
memgentic_briefing(hours=24)

Estratégia de Recuperação Eficiente

Minimize o uso de tokens com uma abordagem progressiva:

1. Comece compacto — Use --format compact para uma visão geral do que existe.
2. Reduza o escopo — Adicione filtro de plataforma (-s claude_code) ou filtro de tipo (-t decision) quando souber o que está procurando.
3. Detalhe completo — Remova --format compact apenas quando precisar do conteúdo completo da memória.
4. Limite resultados — Use --limit para limitar o número de resultados retornados.

# Passo 1: Escaneamento rápido
memgentic search "deploy" --format compact --limit 10

# Passo 2: Resultados relevantes encontrados, obtenha detalhes de uma plataforma específica
memgentic search "deploy" -s claude_code --limit 3

Tipos de Memória

As memórias são classificadas em tipos para filtragem:

Tipo	Contém
decision	Decisões arquiteturais e técnicas com justificativa
learning	Coisas aprendidas durante o desenvolvimento
preference	Preferências do usuário, convenções, estilo de codificação
fact	Conhecimento geral e contexto do projeto
bug_fix	Correções de bugs, causas raiz e soluções
conversation_summary	Resumos de sessões completas

Filtre por tipo para obter resultados precisos:

memgentic search "banco de dados" -t decision    # Apenas decisões sobre bancos de dados
memgentic search "testes" -t preference          # Apenas preferências sobre testes
memgentic search "autenticação" -t bug_fix       # Apenas correções de bugs relacionadas à autenticação

Contexto Multiplataforma

O Memgentic captura de múltiplas ferramentas de IA. Cada memória registra sua plataforma de origem:

Plataforma	ID da Fonte
Claude Code	claude_code
Gemini CLI	gemini_cli
ChatGPT	chatgpt
Aider	aider
Codex CLI	codex_cli
Copilot CLI	copilot_cli
Claude Web/Desktop	claude_web
Antigravity	antigravity

Use a filtragem por fonte para restringir pesquisas:

# O que discutimos no Claude Code sobre este projeto?
memgentic search "arquitetura do projeto" -s claude_code

# O que o ChatGPT sugeriu sobre este tópico?
memgentic search "estratégia de cache" -s chatgpt

# Veja todas as fontes disponíveis
memgentic sources

Métodos de Captura

As memórias entram no sistema através de:

• auto_daemon — Monitor de arquivos captura conversas automaticamente em segundo plano.
• mcp_tool — Armazenadas via chamadas de ferramenta MCP durante sessões de IA.
• cli — Salvas manualmente via memgentic remember.
• json_import — Importadas em lote a partir de exportações de conversas (ChatGPT, Claude Web).

Configuração

# Verificar pré-requisitos
memgentic doctor

# Configuração interativa (seleção de modelo, configuração)
memgentic setup

# Importar conversas existentes de todas as ferramentas de IA detectadas
memgentic import-existing

# Iniciar daemon de captura em segundo plano
memgentic daemon

# Iniciar servidor MCP para integração com ferramentas de IA
memgentic serve