deja-vu

A única memória que seus agentes de codificação compartilham, construída a partir do histórico que já está no seu disco.

Seu agente está prestes a depurar novamente algo que você corrigiu em março — em um agente diferente. deja indexa as sessões que Claude Code, Codex, Cursor e todos os outros agentes nesta máquina já gravaram no disco, e entrega a sessão certa para qualquer agente que a solicitar.

_{Ninguém pesquisou nada — o agente chamou o deja por conta própria. Cada linha é citada de duas sessões reais.}

Toda ferramenta de memória começa vazia e registra daqui para frente. deja começa cheia.

E ninguém precisa pedir: a recuperação chega no início da sessão, a cada prompt, antes de um arquivo ser editado ou um comando ser executado, e depois que um falha. Chaves e tokens são removidos conforme o índice é construído, então o que chega ao modelo é seguro para enviar.

85,3% hit@1 no LongMemEval-S · 69,7% hit@1 de recuperação no LoCoMo · consultas em milissegundos sobre gigabytes de histórico
_{Ambos os harnesses estão neste repositório e rodam nos datasets públicos em minutos · confira os números você mesmo}

English | 中文

Docs · Benchmarks · Como ele se compara · Integrando à sua ferramenta

_{Achou útil? Dê uma estrela no deja-vu no GitHub para que outros desenvolvedores possam encontrá-lo.}

Instalação

curl -fsSL https://raw.githubusercontent.com/vshulcz/deja-vu/main/install.sh | sh
deja install --auto

Dez segundos para instalar, cerca de dez para indexar, e já é útil. O segundo comando conecta a recuperação MCP a todos os agentes que encontrar, ativa a recuperação no início da sessão onde o agente suporta, e constrói o primeiro índice para que a próxima sessão não pague por isso.

Inicie uma nova sessão de agente e pergunte algo em que você trabalhou há meses:

já lidamos com rotação de refresh JWT antes? verifique sua memória

Também não precisa ser perguntado — com a recuperação automática, o agente já sabe o que você resolveu naquele projeto quando a sessão abre.

claude plugin marketplace add vshulcz/deja-vu && claude plugin install deja-vu@deja-vu

scoop install deja-vu

O que você obtém

Resolva no Codex. Claude lembra. Trinta e quatro agentes de codificação gravam cada conversa em arquivos locais, e o deja transforma esses arquivos em uma camada de memória que todos eles leem.

Seu próprio trabalho, embrulhado

deja stats --card desenha no terminal; dê um nome de arquivo e ele escreve um SVG para um README de perfil. Para publicar em qualquer outro lugar, transforme em PNG — essa página converte no seu próprio navegador.

A referência completa de recursos está nos docs.

Privacidade

Indexação e busca são locais. A rede é usada apenas por deja update, deja sync ssh, e a verificação de versão em deja doctor.

Credenciais são redigidas no momento da indexação: chaves AWS, atribuições de api_key= e token=, bearer tokens e JWTs brutos, blocos de chave privada PEM, tokens de provedores, URLs de scheme://user:pass@host, valores de alta entropia para formas que nenhum padrão conhece, e uma senha declarada em prosa — "a senha do admin é …", onde não há delimitador para as outras regras encontrarem. O valor vira [redacted:<kind>] e o texto ao redor permanece pesquisável. deja share e deja sync export reaplicam a redação na saída.

deja forget remove sessões de um índice reconstruído e grava tombstones, para que um deja index posterior não possa restaurá-las do histórico de origem. --unforget levanta um tombstone. Exclusões de projeto são um padrão por linha em ~/.config/deja/exclude; uma linha prefixada com harness: nomeia um store em vez disso — harness:opencode — e o deja nem o percorre nem pede a ferramenta que o leria.

O modelo de segurança documenta fluxos de dados, limites de redação, premissas de confiança e verificação de release.

CLI

$ deja "jwt refresh token"
[claude] api        · Jul 8 · 8f31c0a9 — 2 matches
  login started failing after refresh token rotation; jwt kid mismatch in tests
  fixed by reloading jwks cache after rotateKey and adding a clock-skew test
[codex]  web        · Jul 1 · b77d91e2 — 1 match
  refresh token cookie needed SameSite=Lax in local callback flow

Pergunte ao seu histórico

Referência completa: comandos e saída JSON.

Ferramentas MCP

O servidor expõe uma ferramenta, deja, com um mode. deja install a conecta, então isso só é necessário para configurar um agente manualmente. Os seis nomes de ferramentas mais antigos (recall, recall_context, blame, fix, how, remember) ainda respondem por qualquer coisa já conectada a eles.

Ambientes suportados

Com a recuperação automática instalada, Claude Code e Codex entregam ao deja a transcrição quando uma compactação começa, e ele mantém o que o resumo está prestes a descartar: a tarefa, as conclusões, os arquivos, os comandos com o que cada um fez, e o que ficou em aberto. O próximo hook para a mesma sessão e espaço de trabalho devolve isso uma vez, dentro de um orçamento de 4 KB, com uma linha indicando se o repositório mudou desde então. deja stats conta as chamadas de ferramenta antes da primeira edição após uma compactação, que é o número contra o qual isso é medido. Veja recuperação automática de compactação para saber o que é lido, o que é armazenado e onde estão os limites.

aider · Amp · Antigravity · Claude Code · Cline · Codex CLI · Copilot CLI · VS Code Copilot Chat · Cursor · DeepSeek Harness · Gemini CLI · Goose · Grok Build · Hermes · Kimi Code · omp (Oh My Pi) · OpenClaw · opencode · Continue · Crush · pi · prime-agent (PrimeIntellect) · Qwen Code · Cherry Studio · Senpi · gajae-code · Kimchi Coding · Command Code · ZCode · Kiro · Kilo Code · Roo Code · Zed · CodeWhale.

Locais de armazenamento personalizados passam por variáveis DEJA_*_ROOT, e a variável de realocação de cada agente também é respeitada. O registro de formato de sessão documenta os caminhos observados, esquemas de registro e mapeamento de papéis por ambiente, com fixtures sintéticas mantendo essas descrições verificadas contra os parsers.

Ambientes com um pacote próprio

deja install --auto conecta todos esses seis como qualquer outro ambiente, e isso continua sendo o caminho mais curto. Eles também têm um pacote em seu próprio ecossistema, para pessoas que instalam extensões lá em vez de por um CLI:

Qualquer um dos caminhos é suficiente por si só, e ter ambos não é um problema: os pacotes opencode, dsh, Kimi, Grok e Codex leem o que deja install escreveu e contribuem apenas com o que está faltando, e no Zed ambas as metades usam um único ID de servidor, então não há nada para ter duas vezes, independentemente da ordem de instalação.

Cada um usa o deja que você já tem; a cópia que ele inclui é apenas o fallback.

A mesma busca também é uma habilidade, para qualquer agente que carregue um SKILL.md:

npx skills add https://github.com/vshulcz/deja-vu --skill deja-search   # skills CLI: Claude Code, Cursor, Goose, Copilot…
openclaw skills install @vshulcz/deja-search                            # ClawHub
hermes skills install vshulcz/deja-vu/skills/deja-search                # Hermes

A habilidade aciona o binário deja da etapa de instalação acima; ela não inclui um.

Recuperação semântica (opcional)

Aponte deja embed para um endpoint local Ollama, LM Studio ou compatível com OpenAI com DEJA_EMBED_URL e consultas reformuladas ainda funcionam. Sem um runtime acessível, a busca lexical e a recuperação MCP continuam inalteradas. OpenAI Platform funciona com sua chave padrão:

export OPENAI_API_KEY='sk-...'
export DEJA_EMBED_URL='https://api.openai.com/v1/embeddings'
export DEJA_EMBED_MODEL='text-embedding-3-small'
deja embed

Sem DEJA_EMBED_URL definido, o deja testa localhost:11434 e localhost:1234, então uma máquina já executando Ollama ou LM Studio é detectada sem ser perguntada. DEJA_EMBED_OFF=1, ou DEJA_EMBED_URL=off, desativa esse teste — qualquer outro DEJA_EMBED_URL configurado ainda vence.

Para outro endpoint autenticado compatível com OpenAI, defina DEJA_EMBED_KEY explicitamente:

export DEJA_EMBED_URL='https://example.com/v1/embeddings'
export DEJA_EMBED_MODEL='embedding-model'
export DEJA_EMBED_KEY='...'
deja embed

DEJA_EMBED_KEY tem precedência. OPENAI_API_KEY é usado automaticamente apenas para uma URL api.openai.com HTTPS; nunca é enviado implicitamente para endpoints locais ou de terceiros.

Prova

deja bench recall     # ranking floor: 100 queries, half Russian, CI fails if recall drops
deja bench context    # 30 seeded task chains plus five negative controls
deja bench block      # does the answer survive into what deja hands over
deja bench prompt     # what the per-prompt hook fires on, and what it fires on wrongly
deja bench ingest     # what an update costs: unchanged, a turn, a new transcript, a rename, a rewrite
deja bench read       # what it costs to read a database-backed store, and what one long value does to it

bench block faz a pergunta que os outros três não conseguem: com a sessão certa em mãos, o bloco carrega o que essa sessão resolveu. Oito sessões discutem cada assunto e uma delas o resolve, no meio de sua própria transcrição em vez de no final — então o braço de linha de base, as voltas mais recentes do melhor resultado, pontua zero e um braço acima de zero teve que escolher.

O experimento de contexto compara a recuperação deja contra histórico completo, grep ingênuo e contexto frio. Com a semente padrão:

Mesma cobertura de fatos que fazer grep nos logs brutos por cerca de 250x menos tokens, e cerca de 70x menos do que reproduzir as sessões correspondentes por completo, sem injetar nada nas cadeias onde nenhum fato anterior é relevante. O gerador de corpus e os rótulos de relevância são Go comum revisado. Audite o que "relevante" significa antes de confiar em qualquer número, incluindo os nossos.

Medido em um armazenamento real de 2.419 sessões e 179k mensagens, 1,9 GB de transcrições:

O índice é incremental. Quando um arquivo de sessão cresce, apenas esse arquivo é relido.

Como funciona

Índice invertido local em ~/.cache/deja: analise os armazenamentos JSONL e SQLite, remova credenciais, escreva records.bin além de buckets de tokens, e rastreie o estado por arquivo em manifest.gob para que execuções repetidas apenas ingiram o que mudou. O servidor MCP, estatísticas, compartilhamento e sincronização leem esse único índice. Detalhes em docs/ARCHITECTURE.md.

FAQ

Algo sai da minha máquina? Não, a menos que você peça. Veja os fluxos de dados. E quanto aos segredos que já estão nos meus logs? Eles permanecem nos arquivos originais do harness, que são dados do seu agente. Formatos conhecidos — chaves AWS, atribuições de api_key=/token=, tokens bearer e JWTs simples, blocos PEM, tokens de provedores, valores de alta entropia — são removidos conforme o índice é construído, então não chegam a digests, compartilhamentos ou exportações de sincronização. Correspondência de padrões não é detecção de segredos: um formato que ela não conhece pode passar. Veja o modelo de segurança.

Isso vai deixar meu agente mais lento? Uma recuperação é uma busca lexical em um índice local: ~0,7 ms de mediana, e nada espera por um modelo. Um hook adiciona o início do processo e uma verificação de atualização sobre seus armazenamentos além disso — dezenas de milissegundos em um armazenamento de alguns gigabytes.

Preciso mudar a forma como trabalho? Não. O agente chama a recuperação por conta própria, e com a recuperação automática ele já conhece as decisões anteriores do projeto quando a sessão abre.

Como isso é diferente das outras ferramentas de memória?

engram é o mais forte das ferramentas de registro e vale seu tempo se esse modelo se adequar a você; ele ainda começa vazio e conhece apenas o que um agente escolheu salvar. A comparação completa cobre onze delas.

Onde o histórico de sessões do Claude Code é armazenado, e posso pesquisá-lo? Em ~/.claude/projects, um arquivo JSONL por sessão; o Codex mantém ~/.codex/sessions, o Cursor um SQLite state.vscdb. deja search lê todos no local, deja last lista as sessões recentes de cada agente, e deja view abre todo o histórico como uma única página local. Caminhos para cada agente: onde as sessões são armazenadas.

Meu histórico de sessões do Claude Code desapareceu. Ele se foi? O Claude Code exclui transcrições com mais de 30 dias (cleanupPeriodDays em ~/.claude/settings.json), e claude --resume lista apenas o que resta. Uma sessão que o deja indexou antes da limpeza permanece pesquisável depois que o arquivo se foi. Detalhes: arquivos de sessão no disco.

E o Windows? Existem builds e o CI executa a suíte lá. macOS e Linux são os caminhos testados em batalha. Relatos de campo são bem-vindos em #9.

Como apago tudo?

deja uninstall --all
rm -rf ~/.cache/deja

Guias

Escritos para a situação, em vez do recurso:

• Seu agente lembra de conversas anteriores? — o que cada agente mantém entre sessões, e o que ele descarta
• Arquivos de sessão no disco — o tamanho que ~/.claude/projects atinge, e o que custa excluí-lo
• O agente perdeu o contexto que você tinha — após uma falha, uma limpeza ou uma sessão que voltou vazia
• A janela de contexto está cheia — o que a compactação mantém, medido, e o que fazer em vez disso
• Retomando a sessão de ontem — encontre-a em todos os agentes, reabra-a naquele que a possui
• O agente repete um erro que você já corrigiu
• Encontrando a sessão onde você resolveu isso
• Por que agentes esquecem entre sessões · Onde cada agente mantém seu histórico
• O que a compactação descarta · Trocando de agentes · Auditando um agente · Exportando uma conversa · Entre máquinas · O que a memória custa

Por harness: opencode · DeepSeek Harness · Kimi Code · Zed · Grok Build · Gemini CLI · Qwen Code · OpenClaw · Goose · Cline · pi e omp · Hermes

Experimente com seu próprio histórico

curl -fsSL https://raw.githubusercontent.com/vshulcz/deja-vu/main/install.sh | sh
deja install --auto

Dez segundos para instalar, cerca de dez para indexar. Na próxima sessão que seu agente abrir, ele já saberá o que você resolveu naquele projeto — incluindo tudo de antes de você instalar isso.

Contribuindo

make build test lint, depois CONTRIBUTING.md. Adicionar um harness começa no registro de parsers. Prioridades e não-objetivos estão em ROADMAP.md. Boas primeiras issues estão rotuladas.

Suporte

Bugs e perguntas vão para issues. Qualquer coisa que você ache explorável passa pelo link de advisory privado em SECURITY.md em vez disso. O que o deja lê, o que ele nunca envia para qualquer lugar, e como excluir um projeto ou esquecer uma sessão está em Privacidade.

Licença

MIT © Vladislav Shulcz