Captura de sessões
A captura de sessões permite que uma org colete o que seus membros fazem com ferramentas de IA, para que o Lore depois transforme isso em memória compartilhada da org. Ela vem desligada: nada é capturado até que o owner da org a ligue e reconheça a responsabilidade da org pelos dados.
O que é capturado
- Harnesses: o Claude Code, o Codex CLI e o GitHub Copilot (o Copilot CLI e o alvo de sessão “Copilot” do VS Code, capturados como um só harness,
copilot). Outras ferramentas entram quando seus eventos de captura forem verificados. A org pode limitar a captura a alguns harnesses. - Copilot: pastas confiáveis. Os hooks do Lore para o Copilot ficam em
~/.copilot/hooks/lore.json. O Copilot só roda os hooks do próprio repositório numa pasta confiável, mas os hooks do Lore, no nível do usuário, rodam em qualquer pasta. - Codex: aprove os hooks. O Codex não roda nenhum hook até você aprová-lo em
/hooks(hooks de projeto também exigem uma pasta confiável). Olore hooks installlembra disso, e olore hooks statusavisa quando os hooks do Codex estão instalados mas nunca rodaram. - O quê: os turnos de cada sessão (suas mensagens e as respostas da IA), a partir do transcript da própria ferramenta na sua máquina, só nos projetos que a org incluir (comparados pelo remote do git).
- Quando: no fim de cada turno e quando a sessão termina, pelo
lore hook capture. Umlore syncem segundo plano envia o que foi capturado.
A redação acontece na sua máquina
Antes de qualquer coisa ser gravada no spool local ou enviada, o lore remove segredos com as regras do gitleaks e o pacote de regras do próprio Lore, mais as regras que a sua org acrescentar. Nada sem redação sai da sua máquina.
Retenção e quem vê o quê
| Membro | Owner da org | |
|---|---|---|
| A política de captura da org | sim | sim, e edita |
| As próprias capturas | sim | sim |
| Capturas de outros membros | não | sim, com IPs de envio |
| Apagar capturas | as próprias, se a org permitir | qualquer uma |
| O texto das regras de redação da org | só quantas são | sim |
As capturas brutas ficam guardadas pela retenção da org (de 7 a 30 dias, 14 por padrão) e depois são apagadas automaticamente.
A responsabilidade da org
A sua organização decide capturar e é a controladora dos dados dos seus membros. Ela precisa ter uma base legal para a captura, por exemplo sob a LGPD, e informar os seus membros. O Lore fornece os mecanismos: opt-in no nível da org, redação na máquina do membro, retenção limitada e visibilidade. Se a org ativar a destilação, as capturas viram registros de memória na máquina do membro, pela própria ferramenta de IA da org e sob o contrato da org com o fornecedor dela, e aguardam a revisão da org, a menos que ela escolha o contrário.
Para ligar a captura, o owner da org precisa reconhecer essa declaração no painel. Todo membro vê quem reconheceu e quando.
Armazenamento das capturas
As capturas contam no armazenamento do plano da org, numa reserva de capturas: uma fatia do armazenamento do plano separada para as capturas e para os candidatos a memória destilados delas. Namespaces e memória da org não usam essa fatia, e as capturas não usam a deles.
- Quando o owner liga a captura pela primeira vez, a reserva fica em 20% do armazenamento do plano, ou menos se os namespaces já ocupam mais. O owner pode mudá-la na política de captura, desde que caiba ao lado dos namespaces.
- A página Captures mostra quanto da reserva está em uso, com um aviso aos 90%.
- Quando a reserva enche, novas capturas são recusadas, mas nada é apagado. As capturas esperam no spool da máquina de cada membro, o
lore hooks statusmostra “capture storage full”, e os envios voltam quando a retenção libera espaço ou o owner aumenta a reserva.
Veja Armazenamento e cotas para o pool de armazenamento completo.
Ligando a captura (owner da org)
- No painel, abra a página Captures da sua org.
- Em Edit capture policy, escolha os projetos (globs como
dev.azure.com/acme/*), os harnesses, a retenção, regras de redação extras e se os membros podem apagar as próprias capturas. - Ligue a captura, marque o reconhecimento e salve.
Os membros com os hooks instalados começam a capturar na próxima sessão. O lore hooks install acrescenta os hooks de captura quando a política da org está ligada.
Vendo as suas capturas (todo membro)
No painel, a página Captures da org mostra a política e as suas capturas, turno a turno. Pelo terminal:
lore captures policy --org <sua-org> # a política e a declaração
lore captures ls --org <sua-org> # os seus lotes de captura
lore captures show <id> --org <sua-org>O lore hooks status diz se cada uma das suas orgs captura e mostra um aviso uma vez sempre que a política de uma org muda.
Das capturas à memória da org (destilação)
A destilação transforma capturas em registros de memória curtos e atômicos: decisões e seus porquês, fatos não óbvios sobre os sistemas da org, correções e procedimentos que funcionaram. Ela fica desligada até o owner da org ligá-la.
Onde roda. Na máquina de cada membro, depois que as capturas dele são enviadas: o lore sync executa, em modo não interativo, o harness escolhido pela org para ler a captura e propor registros:
- Claude Code:
claude -p, sem ferramentas, sem servidores MCP e sem configurações do projeto. - Codex CLI:
codex exec --ephemeral --ignore-user-config -s read-only, sem sessão salva, sem hooks nem servidores MCP do usuário, e com sandbox somente leitura numa pasta vazia. Deixe o modelo vazio para usar o padrão do Codex.
O GitHub Copilot não destila: o modo não interativo dele roda os seus hooks e guarda a sessão. As capturas do Copilot são destiladas pelo harness escolhido pela org, como as demais, então uma org que só usa o Copilot pode capturar, mas não destilar.
Não há chave de API para criar: o harness faz login como sempre, e o Lore nunca lê nem guarda as credenciais dele. Os hooks do próprio Lore não fazem nada dentro da chamada, então uma destilação nunca é capturada.
Pré-requisito de TI. A destilação usa o assento do membro no harness escolhido, então ele precisa estar logado na conta da org, não numa conta pessoal. No Claude Code, garanta isso com a configuração gerenciada forceLoginOrgUUID. No Codex, defina forced_login_method = "chatgpt" e forced_chatgpt_workspace_id na configuração gerenciada dele. As duas são distribuídas por MDM, como os hooks gerenciados.
O que a org decide. Na página Captures, o owner define:
- quais categorias manter e quais descartar;
- termos bloqueados: nomes, domínios, codinomes ou qualquer outra coisa que nunca pode aparecer num registro (clientes, parceiros, projetos internos). Eles entram no prompt, que instrui o modelo a não mencionar nem os termos nem detalhes que identifiquem a que se referem, e um filtro na máquina do membro e de novo no Registry descarta qualquer registro que cite um deles. A máquina de cada membro precisa dessa lista, então os membros conseguem lê-la;
- o modelo, quantos registros por chamada e quantos registros existentes são mostrados ao modelo para evitar duplicatas;
- um teto mensal de caracteres de entrada por membro;
- revisão: por padrão, todo registro aguarda o owner na página Memory Review. “Gravar direto” é recusado enquanto a org exigir aprovação.
O que o membro vê. Cada lote na página Captures lista os candidatos destilados dele e o estado de cada um. O membro pode descartar os próprios candidatos pendentes: antes da revisão eles ainda são captura dele, não memória da org. Apagar uma captura também descarta os candidatos pendentes dela.
Registros aprovados viram memória comum da org, com o membro capturado como autor e o harness como plataforma, marcados com a tag source:capture. Cada um mantém sua categoria e o projeto em que foi capturado. Ao aprovar, o owner pode corrigir a categoria. Só registros destilados têm essa tag, então From captures na página Memory (ou lore_memory_list com essa tag) mostra exatamente eles. Os registros aprovados permanecem quando a captura expira.
A página Memory Review também mostra, por categoria, quantos registros o owner aprovou e rejeitou nos últimos 30 dias. Uma categoria quase sempre rejeitada é candidata a sair da política.
Status na sua máquina. O lore hooks status mostra, por org, o harness e a versão da destilação, quantos deltas estão na fila e a entrada do mês contra o teto. O lore captures ls mostra o estado de destilação de cada delta. Os deltas esperam cerca de 10 minutos a sessão assentar, e então os turnos de uma sessão são destilados juntos. Um delta sem nada que você tenha digitado é pulado sem chamada.
Ligar a destilação exige reconhecer a versão 2 da declaração de responsabilidade. A captura continua funcionando enquanto o reconhecimento estiver desatualizado; a destilação espera por ele.
Lendo a memória da org
Todo registro tem uma categoria opcional, mostrada no painel com um rótulo simples:
| Categoria | Rótulo | O que guarda |
|---|---|---|
procedures | How to | passos que funcionaram |
corrections | Pitfalls | o que parecia certo e estava errado |
decisions | Decisions | o que foi escolhido e por quê |
system-facts | Facts | como os sistemas da org realmente se comportam |
Registros destilados de capturas também levam o projeto: o repositório em que foram capturados. A página Memory tem três visões:
- Browse (padrão): registros agrupados por projeto e depois por categoria, com o conteúdo completo. Filtre por projeto, categoria ou origem; cada visão filtrada tem sua própria URL.
- Página do projeto: tudo o que a org sabe sobre um repositório, por categoria. Uma boa primeira leitura para quem está chegando ao projeto.
- Overview: uma matriz projeto × categoria com contagens, e o que foi adicionado ou atualizado por categoria nos últimos 7 e 30 dias. Nunca conta nem ranqueia pessoas.
O grafo de wikilinks foi para a aba Graph. Registros destilados de capturas ainda não se ligam entre si, então o grafo mostra poucas arestas.
As ferramentas de IA usam a mesma classificação: lore_memory_store aceita category e project opcionais, e lore_memory_list e lore_memory_search filtram por eles (category: none lista os registros sem categoria).
Registros gravados antes das categorias não têm uma. O owner da org pode preenchê-los uma vez com lore memory reclassify, que roda na máquina do owner, como a destilação.