Skip to main content
A memória do projeto salva instruções para sessões futuras em um projeto local. Ela fica desativada por padrão, e você escreve e aprova cada preferência. Por exemplo, salve uma instrução para incluir um teste de regressão sempre que o agente corrigir um erro.

​
Escolha o que lembrar

Use memória para instruções válidas entre tarefas do mesmo projeto: comando de testes, restrição de compatibilidade ou convenção de revisão. Deixe um bug específico ou investigação temporária na sessão. Ativar memória não extrai preferências de conversas anteriores; você escreve e aprova cada texto. Salve apenas instruções aplicáveis ao projeto. Não inclua chaves de API ou senhas: preferências ativadas são enviadas nas solicitações ao modelo.

​
Salve uma preferência do projeto

Com uma conta verificada conectada, abra Ajustes → Projetos, selecione a pasta e ative Memória neste projeto. Escreva uma preferência, revise-a e escolha Aprovar e salvar. Cada conta e pasta tem suas próprias preferências; worktrees separados também têm memórias separadas. Para um projeto com testes, uma preferência útil especifica a verificação esperada:
Ao corrigir um erro, adicione um teste de regressão que o reproduza. Execute os testes relevantes após a correção e informe o comando e o resultado.
Salve preferências específicas do projeto. Uma convenção de testes pode orientar sessões futuras, mas você ainda deve conferir a saída real antes de aceitar uma alteração. Para reutilizar a preferência em outro worktree, configure a memória dessa pasta também.

Uma preferência aprovada do projeto pede um teste de regressão e o resultado real dos testes após cada correção.

​
Configure o padrão e a exceção do projeto

Em Ajustes → Projetos, selecione uma pasta ou use Adicionar pasta…. Essa seleção pode ser diferente do projeto aberto em Código: confira a pasta antes de salvar. Em Todos os projetos, a opção de memória por padrão define o estado inicial dos projetos locais da conta. Memória neste projeto oferece: O padrão compartilha a configuração de ativação, não o texto. Um projeto novo começa com uma lista vazia. Worktrees separados também têm listas distintas.

​
Edite ou remova preferências

Confira preferências e datas de aprovação nos ajustes do projeto. Edite e aprove novamente quando uma convenção mudar. Use Buscar preferências quando a busca aparecer para uma lista maior. Excluir remove uma entrada. Limpar memória do projeto remove todas as preferências da conta e pasta após confirmação, sem mudar a ativação. Desativar preserva a lista e permite revisar ou excluir; adicionar ou editar exige ativar novamente. Um projeto aceita até 50 preferências, 2.000 caracteres por entrada e 12.000 no total. Ao atingir um limite, reduza ou remova uma entrada em vez de duplicar a mesma instrução.

​
Como as preferências são usadas

As preferências ficam no armazenamento local e são incluídas nas solicitações ao modelo enquanto a memória está ativada. Desativá-la mantém as preferências salvas, mas deixa de adicioná-las às solicitações futuras. As conversas anteriores mantêm o texto das preferências que já receberam. O recurso exige login com uma conta e um projeto local; acesso apenas por chave de API e ambientes remotos não oferecem suporte a ele.

​
Confira as preferências utilizadas

Se uma preferência esperada não aparecer, confira conta, gateway, pasta e estado efetivo. Outro worktree do mesmo repositório não herda as preferências da pasta original. Mudar a memória pode interromper um turno local; reenvie a solicitação se necessário. Excluir uma preferência não reescreve conversas que já a contêm. Inicie uma sessão nova se precisar deixar de reutilizar esse texto anterior. Continue com Sessões e contexto do projeto.