Memória

Guarde informações úteis do projeto em Markdown para reutilizá-las em sessões futuras.

A memória do Clarvis guarda informações úteis do projeto em arquivos Markdown: comandos que funcionam, decisões de arquitetura, erros recorrentes e os motivos de uma solução alternativa. Você pode ler e editar esses arquivos. O armazenamento padrão não precisa de banco vetorial nem embeddings.

Diferencie memória, sessões e contexto

• O histórico da conversa da sessão é o registro durável do que pessoas e agentes disseram e fizeram.
• O contexto do modelo é o conjunto de trabalho limitado enviado a uma chamada e pode ser compactado.
• A memória é conhecimento curado para reutilização entre execuções no mesmo workspace.

A memória não copia todas as conversas. A maioria das execuções não precisa de atualização. Os detalhes ficam em arquivos MEMORY.md, organizados por resumos de tópicos. PROFILE.md é o índice geral do projeto.

<workspace>/.clarvis/memory/
├── PROFILE.md
└── build/
    ├── TOPIC.md
    └── bun/
        └── MEMORY.md

Ative a memória

Abra /settings/memory, escolha o escopo global ou do workspace, crie o bloco de memória e selecione o modelo usado para extrair conhecimento durável. Salve a alteração para as próximas execuções. A linha da sessão permite desativar ou reativar temporariamente a memória já configurada sem reescrever as configurações.

A memória precisa de um modelo de extração efetivo. Ela usa o modelo específico quando configurado e, caso contrário, o modelo padrão efetivo. Se nenhum dos dois for resolvido, o Clarvis mantém a configuração, mas avisa que não pode aprender.

Acompanhe como uma execução aprende

No início da execução, o Clarvis adiciona ao contexto do agente o resumo limitado de PROFILE.md. Agentes com acesso à memória podem pesquisar e ler documentos mais profundos. O líder pode atualizar a memória pelas ferramentas protegidas; subagentes recebem leitura, mas não podem conceder a si mesmos autoridade de escrita.

Quando uma execução termina, o Clarvis salva uma tarefa em segundo plano para revisar o pedido, o resultado e um conjunto limitado de evidências das ferramentas. A memória só muda se houver algo útil a guardar. Você pode começar a próxima tarefa sem esperar essa revisão.

Diga ao Clarvis o que merece ser anotado

Adicione orientação em Markdown simples em um ou nos dois locais:

Arquivo	Escopo	Compartilhar?
~/.clarvis/memory-policy.md	sua preferência em todo lugar	não
<workspace>/.clarvis/memory-policy.md	expectativas deste projeto	opcionalmente versionado

As duas políticas se combinam, começando pela global. Escreva orientação editorial sobre o que é útil, não uma estrutura substituta para a wiki:

Registre o comando exato que corrigiu um build e explique por que funcionou.
Não preserve dados de clientes, credenciais temporárias nem aliases pessoais do shell.

Alterações da política valem na próxima indexação, sem reiniciar o Clarvis.

Mantenha a memória inspecionável e segura

O backend de arquivos padrão fica nos dados do Clarvis dentro do workspace e continua diretamente legível como Markdown. Segredos são removidos dos snapshots limitados antes da indexação, mas uma política de memória ainda é importante: não instrua um agente a reter dados sensíveis que não devem fazer parte do conhecimento durável do projeto.

O Clarvis também pode usar um provedor de memória MCP ou de plugin configurado. O provedor efetivo é responsável pelo armazenamento e pelas capacidades; um provedor somente leitura nunca recebe uma escrita de indexação. Trocar de provedor não reproduz escritas pendentes em outro backend.

Veja também

• Como o Clarvis funciona
• Configuração
• Uso diário
• Segurança e controle