Skip to Content
Pt BrV1Referência CLIlore pull

lore pull

Baixe e instale um package Lore no projeto atual.

Uso

lore pull <namespace>/<name>:<version> [flags] lore pull [--sdd <namespace/nome[:versão]>] [--dry-run] # o framework de SDD do projeto

Descrição

Baixa o arquivo .lore do registry, descomprime e escreve os artefatos específicos da plataforma no diretório do projeto. A plataforma alvo é detectada automaticamente a partir do runtime de IA presente no projeto.

Flags

FlagDescrição
--target <runtime>Substituir o runtime detectado automaticamente (ex.: claude-code, cursor, raw)
--output <dir>Diretório de saída (padrão: .)
--registryURL do registry
--qualified-namesInstala como {namespace}-{name}, para que pacotes de mesmo nome em namespaces diferentes coexistam. O padrão vem de naming no .lore/config.yaml; --qualified-names=false passa por cima dele
--sdd <pacote>Sem pacote: instala este framework de SDD em vez do do projeto, da org ou do padrão
--dry-runSem pacote: mostra qual framework de SDD vale, sem instalar nada

Exemplos

# Baixar uma versão específica lore pull m1cloud/azure-architect:1.0.0 # Baixar com target explícito lore pull m1cloud/azure-architect:1.0.0 --target cursor # Baixar em um diretório específico lore pull m1cloud/azure-architect:1.0.0 --output ./ai-config

O framework de SDD do projeto

Sem pacote, o lore pull instala o framework de SDD do projeto: o primeiro definido entre --sdd, a chave sdd do .lore/config.yaml mais próximo (até a raiz do repositório), a escolha da org no painel e o padrão do Lore, lore/openspec.

A org é encontrada como o hook de governança a encontra: o --org, senão o .lore.yaml do repositório (lore hooks pin --org=<org>), senão o LORE_ORG. Isso vale só para o lore pull sem pacote; o lore pull <pacote> continua escopado por --org ou LORE_ORG.

$ lore pull SDD framework: acme/bmad-method (org) ✓ Scaffold instruction → .claude/scaffolds/bmad-method.md

Ele instala esse Scaffold como o lore pull <pacote> faria, em todos os targets detectados. Recusa um pacote que não é framework de SDD (um kind: Scaffold com spec.sddFramework: true) e sai com erro. --dry-run mostra a resolução sem instalar; o lore sdd status mostra cada camada.

.lore/config.yaml

Configurações do projeto que todo comando lore rodado nele segue. O CLI lê o arquivo e nunca o grava.

ChaveValoresEfeito
namingplain (padrão), qualifiedInstala pacotes como {namespace}-{name} (veja abaixo)
sddnamespace/nome[:versão]O framework de SDD do projeto, no lugar do da org. Vale o arquivo mais próximo que o define

Alvos de Runtime

A CLI detecta o runtime automaticamente a partir de arquivos no projeto:

Arquivo presenteTarget detectado
CLAUDE.mdclaude-code
.cursorrulescursor
AGENTS.mdopenai-agents
(nenhum)raw

Pacotes de mesmo nome em namespaces diferentes

Por padrão, um pacote é instalado com o nome sem namespace. Então nextjs/design-system e react-native/design-system gravam os dois em .claude/skills/design-system/SKILL.md, e o último pull vence. Para manter os dois, instale com nomes qualificados:

lore pull nextjs/design-system --qualified-names lore pull react-native/design-system --qualified-names # → .claude/skills/nextjs-design-system/SKILL.md (name: nextjs-design-system) # → .claude/skills/react-native-design-system/SKILL.md (name: react-native-design-system)

Para que isso seja o padrão do projeto, seguido por todo pull e todo script que rode nele, crie o .lore/config.yaml:

naming: qualified

O nome qualificado vale para todos os targets e kinds (skills, rules, specs, agents, scaffolds, instruções de include) e para as dependências instaladas pelo mesmo pull. Um nome de Skill qualificado precisa caber no limite de 64 caracteres dos nomes de skill do Claude e do Copilot: se passar, a instalação daquele pacote falha, em vez de o nome ser cortado.

Marca de origem

Todo arquivo que o lore pull grava a partir de um pacote registra de onde veio, logo depois do frontmatter (ou na primeira linha, quando não há frontmatter):

<!-- lore: nextjs/design-system@1.0.1 org=laca -->

O org= só aparece em pacotes de namespaces privados de uma org. Arquivos extraídos de spec.include não recebem a marca.

Antes de gravar, o lore pull lê a marca de um arquivo que já esteja no caminho de destino e avisa no stderr (com [WARN]) quando:

  • o arquivo veio de outro pacote, e então é sobrescrito;
  • com nome qualificado, a instalação sem prefixo do mesmo pacote ainda existe, por exemplo de antes da troca. Remova-a; o CLI nunca apaga;
  • com nome qualificado, existe um arquivo de mesmo nome sem marca.

Pacotes que citam outros pacotes

No conteúdo de um pacote, cite outro pacote pelo ID (backend/dotnet-service-scaffold), nunca pelo caminho de instalação: o caminho muda com o nome qualificado e com o target. O agente encontra o arquivo instalado procurando por lore: backend/dotnet-service-scaffold@ no projeto, ou carrega o pacote com lore_get.

Ao atualizar o CLI, todo arquivo instalado ganha uma linha com a marca, mesmo sem nome qualificado. Repositórios que versionam os arquivos instalados vão ver essa diferença uma vez.

© 2025 Lore · Built by M1 Cloud