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:
| Ferramenta | Arquivo |
|---|---|
| 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 statusexplica 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:
| Ferramenta | Hook de repositório considerado em execução |
|---|---|
| Claude Code | Sim |
| GitHub Copilot | Só quando o repositório está nas pastas confiáveis do Copilot (trustedFolders em ~/.copilot/config.json) |
| OpenAI Codex | Desconhecido: o Lore não consegue ler as aprovações de hooks do Codex |
| Cursor | Desconhecido: 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.