Instalar de um repositório

Ver como MarkdownA mesma página em texto puroAbrir no ChatGPTPerguntar sobre esta páginaAbrir no ClaudePerguntar sobre esta página

Qualquer repositório do GitHub como raiz de busca, e como um caminho tree fixa um branch, uma tag ou um commit.

O catálogo embutido no overpower envelhece por construção: ele é fixo na versão que você tem instalada, e renová-lo significa esperar uma nova passada de curadoria. O --from é a saída que não espera. Ele aponta para qualquer repositório do GitHub, sem passo de registro, e lê de lá em vez do catálogo embutido.

Antes de começar

Um git local funcionando, com as credenciais que você já usa. O overpower reaproveita as suas, então um repositório privado que você já consegue clonar funciona aqui também. Se o git não estiver disponível, ele cai para buscar um tarball anônimo usando só a biblioteca padrão do Python.

Os passos

1. Perguntar o que o repositório oferece

   Nu, sem seletor nenhum, o --from imprime a vitrine daquele repositório: as skills sob skills/, mais os bundles e os servidores MCP que o .overpower.yaml da raiz declara.

   uvx overpower@latest list --from https://github.com/owner/repo

2. Ler um item inteiro antes de instalar

   Cada um dos três também aceita seletor, então um item pode ser lido por inteiro antes de qualquer escrita. Todo comando que a vitrine imprime carrega o --from de volta, porque um item lido assim não está no catálogo embutido e a linha sem ele seria respondida por outro catálogo.

   uvx overpower@latest list --skill alguma-skill --from https://github.com/owner/repo

3. Fixar a referência e instalar

   Acrescentar tree/<ref>/<path> à URL fixa um branch, uma tag ou um SHA de commit inteiro. Fixar um SHA é o que torna uma instalação por --from inteiramente reprodutível.

   uvx overpower@latest install --from https://github.com/owner/repo/tree/main/subpasta --skill alguma-skill --runtime codex

Verificação

Rode a mesma linha com --dry-run antes de escrever qualquer coisa:

uvx overpower@latest install --from https://github.com/dono/repo --skill <nome> --dry-run

A saída lista o caminho de destino de cada arquivo e a procedência de cada um. A procedência deve apontar para o repositório que você nomeou; se ela citar o catálogo embutido, a URL não foi lida como raiz de busca.

Depois de instalar, confirme o que aterrissou:

uvx overpower@latest doctor

O doctor fecha em zero achado quando a instalação está sã, e sai 0.

Um nome que o repositório remoto não tem sai 3, e não 2. É a diferença que o --from faz no modelo de erro, e ela está em códigos de saída.

O que o --from consulta

O --from é exclusivo. Uma vez na linha, só o repositório remoto é consultado: o catálogo embutido não é procurado, e também não é fundido com o remoto. Isso resolve a questão de precedência entre os dois removendo-a, em vez de respondendo-a.

A única flag que o --from recusa é --ai-framework, e a recusa é uma afirmação sobre o modelo, não uma posição de fila. Um framework é uma pasta da wheel do próprio overpower, então não há nada no repositório de outra pessoa para a flag nomear. Essa linha sai 2 antes de qualquer busca.

Os três seletores não leem a URL do mesmo jeito. Só o --skill a trata como raiz de busca, e o repositório, uma subpasta ou a pasta do próprio artefato chegam todos ao mesmo resultado. O --bundle, o --mcp e a vitrine nua estão ancorados na raiz do repositório, no .overpower.yaml que mora lá, então a subpasta da URL não estreita nada: o que um repositório oferece, e o que ele compõe, são propriedades do repositório e não do caminho que você por acaso colou.

O --mcp deixou de andar pela árvore, e a mudança acompanha o formato: a receita virou uma entrada da declaração, então ela é ancorada junto com ela.