lore

lore é uma ferramenta de linha de comando local e um explorador web para tudo o que o Claude Code escreve em uma máquina. O Claude Code mantém transcrições de sessão, memória e histórico de prompts em um diretório de dados, fragmentado por projeto, e sua retenção padrão exclui transcrições após aproximadamente 30 dias. O lore mantém um espelho aditivo desses dados brutos, indexa-os e fornece uma superfície de consulta sobre seu próprio histórico de sessões. Instalação e plataformas: o projeto requer Bun e nada mais, sem dependência de rsync ou toolchain. Sua integração contínua executa a suíte de testes e instala o binário no macOS, Linux e Windows. Todos os verbos funcionam nas três plataformas, incluindo o explorador. A exceção é o supervisor do servidor lore, que mantém o explorador funcionando em segundo plano via um agente de usuário launchd, portanto, é exclusivo para macOS e, caso contrário, orienta os usuários para o lore serve. O script de instalação constrói um binário congelado, recusa uma árvore de trabalho suja, e cada invocação relata sua versão e commit no stderr. Um script harness-corpus tira snapshots das formas do daemon em fixtures de teste após uma atualização do Claude Code. Modelo de dados e indexação: um "well" é o armazenamento de um diretório sob o caminho de projetos do Claude, nomeado a partir de seu caminho absoluto com caracteres não alfanuméricos achatados, portanto, a nomenclatura é com perdas. Cada sessão é um log de eventos JSONL em vez de um log de chat, consistindo principalmente de tráfego de ferramentas, envelopes de pensamento e eventos de harness, juntamente com transcrições de subagentes irmãos e scripts de fluxo de trabalho. O comando index varre os wells, analisa o JSONL e constrói um índice SQLite FTS5 com faixas de spawns e workflows, incrementalmente por tempo de modificação e tamanho. O índice é um artefato derivado e reconstruível que incrementa a versão em vez de migrar e recusa-se a abrir um banco de dados escrito por uma versão mais nova do lore. Comandos: archive espelha o diretório de dados do Claude em um arquivo lore sem propagar exclusões upstream; wells lista armazenamentos com caminhos reais des-slugados e flags; sessions e session percorrem o arco cronológico de um well ou descarregam uma sessão por faixa; search consulta FTS5 entre faixas e pode incluir a espinha do histórico de prompts; spawns relata o modelo verificado versus o solicitado por subagente com flags de drift e custo de boot; workflows resume execuções de orquestração; polls sinaliza sessões que releem um arquivo de saída de tarefa de fundo a cada turno, com preço; tools conta invocações de ferramentas, habilidades e comandos; usage traça perfis de classes de tokens faturados mais pensamento por well, sessão, modelo, dia, semana ou mês com um equivalente de preço de tabela datado; trace renderiza uma sessão como transações, etapas, chamadas de ferramentas e anotações; agents junta a lista ativa ao índice; stats relata totais do corpus, faixas e avisos. Cada comando suporta saída de ajuda, e muitos aceitam um filtro de well que corresponde a substrings, além de uma flag para correspondência exata de valor total. Explorador: lore serve renderiza o índice como páginas HTML renderizadas no servidor para sessões e wells recentes, uso de tokens, wells e sessões individuais, resultados de pesquisa e trailers de sessão escritos em mensagens de commit. Cada página também pode responder em JSON, verbos de leitura são montados sob um caminho de comando com uma especificação OpenAPI, e o verbo api expõe os mesmos manipuladores que os comandos. A porta padrão é 4949 e as opções de host controlam a vinculação, incluindo um endereço Tailscale quando disponível. Camada de julgamento: acima da CLI determinística e livre de modelos, situa-se um fluxo de trabalho de wiki opcional. wiki init cria um repositório git de markdown a partir de um template integrado e skills add instala habilidades por comando para que as sessões do Claude Code descubram a CLI. Ingerir material bruto na wiki, graduar páginas da wiki em documentos commitados no git e fazer linting de cânones obsoletos são protocolos que uma sessão interativa do Claude executa dirigindo a CLI; eles estão documentados nas notas de design em vez de serem enviados como comandos, portanto, a ferramenta em si não precisa de chave de API. Um verbo docs indexa markdown commitado em repositórios, lido de objetos git em vez de árvores de trabalho. Manipulação de dados: ele lê o diretório de dados do Claude e, para docs, stores de objetos git sob uma raiz de código; ele escreve no diretório home do lore, em um repositório wiki opcional e, apenas para o supervisor do macOS, em um plist do launchd. Não há atividade de rede além de um git fetch explícito quando solicitado para indexação de docs e a porta na qual o explorador escuta; nada é carregado e não há chamadas de modelo, telemetria ou contas. A configuração é feita através de variáveis de ambiente validadas, como o dir do Claude, home do lore, dir de código, dir da wiki e listas de exclusão e assistência de docs. Um script Python separado e sem dependências lê o JSONL da transcrição diretamente e relata chamadas de ferramentas negadas, divididas por motivo e pelo que a sessão fez a seguir, com um runbook descrevendo como revisá-las. Status: uma ferramenta pessoal inicial publicada como está, apenas local, sob a licença MIT, sem plano de se tornar um produto.