As páginas sem tradução abrem em inglês e são identificadas como inglês.
O original em inglês mudou desde esta tradução automática. Consulte a página em inglês para ver as instruções atuais.
Esta página é uma tradução automática da página em inglês, que prevalece. Machine-translated from the English page, which is authoritative.
Memória vinculada ao código para agentes de programação
O Loom vincula as memórias dos agentes de programação às funções, classes e arquivos que elas citam, acompanha esses elementos ao longo de refatorações e sinaliza uma memória quando o código dela muda. Por padrão, a busca deixa de fora uma memória cujo código sumiu por completo, a menos que uma pessoa a tenha fixado, bloqueado ou verificado, e toda leitura que serve uma lição informa quando o código dela mudou ou sumiu. Funciona por MCP, HTTP e pelos SDKs nos repositórios que um Loom auto-hospedado indexa (o
índice de código, LOOM_CODE_INGEST_ENABLED=true), e o worker memory_code_links, que mantém os vínculos, vem ativado por padrão.
O que você obtém
- Lições anexadas ao código a que se referem. Uma memória marcada com
repo:<id>(os plugins do Claude Code e do Codex marcam o que seus hooks capturam) ou escrita no namespace de código do repositório é vinculada a cada definição (função, classe ou outro símbolo) que ela cita entre crases, ou em qualquer ponto do texto comoA::bou uma chamada (a.b(),name()), desde que resolva para exatamente um lugar (um nome sem qualificação precisa ter quatro ou mais caracteres); às definições nos arquivos que ela lista e que cita por uma palavra simples em camelCase ou snake_case; e a cada arquivo que ela lista e que não contém nenhuma delas. Um nome qualificado que ainda não está no trunk é vinculado se for mesclado em atéLOOM_MEMORY_CODE_LINKS_PENDING_DAYS(14 dias). Memórias vinculadas ao código - Vínculos que acompanham refatorações. A cada commit indexado, cada vínculo fica como
fresh,moved,changed(indicando o commit que o alterou),unresolvedoumissing. Um vínculo registra os tokens da definição, então espaços em branco, comentários e a maioria das mudanças de formatador o mantêm comofresh. Estados do vínculo - Memórias desatualizadas tratadas como você escolher. A
code_change_policydo namespace decide:retire_removed(o padrão) deixa de fora da busca uma memória cujo código sumiu por completo e sinaliza código alterado;flagapenas sinaliza;revisetambém deixa de fora as memórias com código removido e faz o modelo conferir a afirmação de uma memória alterada contra o código antigo e o novo: se ela ainda vale, é reancorada, e se for contradita, recebe uma sugestão de correção. Uma memória que uma pessoa fixou, bloqueou ou verificou nunca é deixada de fora. Em todas as políticas, a busca costuma classificar uma memória cujo código mudou abaixo dos três resultados seguintes em vez de escondê-la; uma memória retida e uma linha encontrada por nome mantêm sua posição. O Loom nunca reescreve a memória em si. Políticas - Lições onde quer que o agente leia código.
code.symbolretorna as memórias vinculadas a uma definição comolessons;code.search,code.callers,code.callees,code.impact,code.outlinee ocode.context_packde uma tarefa anexam as lições dos arquivos que retornam; cada lição traz seu estado de vínculo. Os hooks do Claude Code e do Codex mostram as memórias de um arquivo (memory.for_file) antes de um agente editá-lo, e os hooks do Cline fazem isso quando ele lê ou edita um arquivo.code.symbol· Plugin do Claude Code · Plugin do Codex · Hooks do Cline (experimental) - Compartilhado com a equipe. As lições são lidas do namespace de código do repositório e dos namespaces que a chamada nomeia (por MCP, o do próprio chamador por padrão), então uma lição salva no namespace de código do repositório chega a todo agente que possa ler esse namespace (um token restrito ao seu próprio usuário ou sessão não lê lições). Memórias vinculadas ao código
- Branches leem o próprio código. Em outra branch, uma lição é verificada contra a definição daquela branch, então uma branch de release que ainda tem o texto antigo fica como
fresh(em um host comLOOM_GIT_HISTORY=none, que não tem espelho git, uma lição traz o estado do trunk). Memórias vinculadas ao código - Documentos ao lado do código. Documentos de uma fonte registrada no namespace de código do repositório (o do trunk) carregam a tag do repositório, então as buscas no repositório os leem junto com o código (o worker de sincronização precisa de
LOOM_KNOWLEDGE_SOURCE_SYNC_ENABLED). Fontes de documentos - Uma lista de revisão.
namespace.validatelista as memórias cujo código mudou, não foi encontrado de novo ou sumiu, e o painel mostra os vínculos de cada memória e o estado deles.

Primeiros passos
O Início rápido inicia o Loom, e
adicionar repositórios ativa o índice de código para um repositório. Conecte seu agente de programação com o plugin dele ou por MCP
(conectar um agente de programação). Salve uma lição que cite, entre crases ou como chamada, uma definição de quatro ou mais caracteres (`name()`), ou uma qualificada como `Reader.run`. Os plugins do Claude Code e do Codex marcam o que seus hooks capturam com repo:<id>, e o primer da sessão informa o id
(como ele é derivado). Uma lição que o próprio agente salva com loom_memory_set é vinculada quando carrega essa tag (tags: ["repo:<id>"]) ou é escrita no namespace de código do repositório; qualquer cliente pode fazer uma das duas coisas. Por HTTP (ou agent.call no SDK Python), uma lição salva no seu próprio namespace só é lida quando a chamada nomeia esse namespace em lesson_namespaces. Cada passada de vinculação vincula as escritas com pelo menos 60 segundos de idade e as passadas rodam a cada 60 segundos, então, assim que o trunk estiver indexado, code.symbol nessa definição retorna a lição em lessons em cerca de dois minutos.
Algumas operações desta página estão marcadas como experimentais na página de status.