Skip to Content
Pt BrV1GovernançaModo repositório

Modo repositório

Versione o hook num repositório, e todo mundo que abrir o repositório recebe o contexto da sua org, sem precisar configurar o hook pessoa por pessoa. Funciona em todos os planos.

Adicione o hook a um repositório

Escolha uma das opções:

  • Pelo terminal, dentro do repositório:

    lore hooks install --scope=project --org=<sua-org>

    Isso mescla a entrada do Lore no arquivo de configuração de projeto de cada ferramenta, mantendo o que já existe.

  • Pelo painel, vá em Governance Hooks → Repository, escolha as ferramentas e baixe os arquivos. Se um arquivo já existir no repositório, adicione a entrada do Lore a ele em vez de substituí-lo.

Os arquivos são:

FerramentaArquivo
Claude Code.claude/settings.json
OpenAI Codex.codex/hooks.json
GitHub Copilot.github/hooks/lore.json
Cursor.cursor/hooks.json

O comando versionado chama o lore pelo PATH, então funciona na máquina de qualquer membro.

O que cada membro precisa

Cada membro continua precisando do Lore CLI e do lore login (veja o Modo individual, passos 1 e 2). Sem login, a sessão mostra um aviso de uma linha no lugar do contexto.

O Codex só roda hooks de repositório depois que cada membro confia no projeto e aprova o hook em /hooks, e algumas interfaces do Codex ainda não rodam hooks de repositório. Para o Codex, prefira o modo individual, ou o modo org quando estiver disponível.

O Claude Code, o Copilot e o Cursor também só rodam hooks de repositório em pastas em que o membro confia.

Indique a org com o .lore.yaml

Uma alternativa mais leve a versionar hooks: um arquivo .lore.yaml na raiz do repositório que indica a org. Os hooks do Lore dos próprios membros (modo individual) passam a entregar o contexto dessa org neste repositório, em vez da org para a qual instalaram o hook. Nada é gravado nos arquivos de configuração das ferramentas.

lore hooks pin --org=<sua-org> # grava o .lore.yaml na raiz do repositório git add .lore.yaml && git commit -m "chore: bind repository to <sua-org> in Lore"

O lore hooks pin confere se você pertence à org. O lore hooks pin --remove apaga o arquivo.

O arquivo fica assim, e um subdiretório pode ter o seu próprio para indicar outra org (vale o arquivo mais próximo):

# Lore: this repository belongs to the acme org. Written by `lore hooks pin`. org: acme
  • O arquivo só escolhe a org. Um membro que não pertence a ela recebe um aviso de uma linha e nenhum contexto. O Lore não volta para a outra org do membro naquele repositório.
  • Os hooks do modo org (gerenciado) e de repositório ignoram o arquivo.
  • Um arquivo inválido é ignorado, e o lore hooks status explica o motivo.

Quando mais de um hook do Lore roda

Se um membro tem o próprio hook do Lore e o repositório também tem um, o hook do repositório responde e o do membro fica calado, mas só quando o Lore consegue saber que a ferramenta roda o hook do repositório para aquele membro:

FerramentaHook de repositório considerado em execução
Claude CodeSim
GitHub CopilotSó quando o repositório está nas pastas confiáveis do Copilot (trustedFolders em ~/.copilot/config.json)
OpenAI CodexDesconhecido: o Lore não consegue ler as aprovações de hooks do Codex
CursorDesconhecido: ainda não verificado

Quando é desconhecido, os dois hooks respondem, cada um com a sua org, em vez de arriscar uma sessão sem contexto. O lore hooks status sinaliza isso. Para evitar, use o .lore.yaml em vez de um hook de repositório, ou mantenha os dois hooks na mesma org.

© 2025 Lore · Built by M1 Cloud