> [Índice para máquinas](https://thiagopanini.github.io/panlabs-docs/llms.txt) · [Página](https://thiagopanini.github.io/panlabs-docs/ferramentas/bibliotecas/overpower/comandos/install)

# overpower install

> Escreve. Imprime o plano, com todo destino e quem o lê, antes de encostar em disco, e pergunta antes de escrever quando há um terminal do outro lado.

**Comando** · `overpower install`

<PainelComando />

Os quatro seletores se misturam livremente numa linha só, e cada um aceita valor separado por vírgula, a repetição da flag, ou as duas coisas. Quando a linha resolve para escritas em mais de uma unidade, elas acontecem sempre na mesma ordem, framework, depois bundle, depois artefato avulso, depois servidor MCP, e a unidade mais específica escreve por último.

Num terminal, uma linha que não fecha um plano abre o assistente em vez de simplesmente recusar. Ele abre só os passos que a sua linha deixou em aberto, sempre na mesma ordem, e o que ele coleta vira exatamente a mesma requisição que a linha digitada à mão teria montado.

## Opções

<ParamField name="--skill" type="name">
Uma skill do pool, instalada sozinha. Aceita a forma curta `-s`.
</ParamField>

<ParamField name="--runtime" type="key">
Quem recebe o que foi instalado. Aceita as chaves de uma tabela fechada de 77 runtimes, e não tem valor padrão. O que acontece sem ele depende de haver terminal: num terminal, uma linha que nomeia o que instalar e nenhum runtime abre o assistente no passo que faltou; fora de terminal, ela recusa com saída 2 em vez de adivinhar. A exceção é a linha que mistura skill e servidor MCP, que exige o runtime nomeado nos dois casos.
</ParamField>

<ParamField name="--bundle" type="name">
Um bundle, expandido nos artefatos de pool que o manifesto dele nomeia. Aceita a forma curta `-b`.
</ParamField>

<ParamField name="--mcp" type="name">
Um servidor MCP, enxertado na configuração do próprio runtime. Aqui nada é copiado, e sim acrescentado dentro de um documento que já é seu.
</ParamField>

<ParamField name="--ai-framework" type="name">
Um AI Framework, instalado inteiro. Ele não tem forma curta de propósito, porque `-f` já é `--force` neste mesmo comando.
</ParamField>

<ParamField name="--from" type="url">
Instala a partir de um repositório do GitHub, sem passo de registro. Uma vez na linha, o catálogo embutido não é consultado.
</ParamField>

<ParamField name="--dry-run" type="flag">
Resolve tudo, imprime o plano, espelha o código de saída real e não escreve nada, nem um diretório vazio.
</ParamField>

<ParamField name="--yes" type="flag">
Pula a confirmação antes da escrita. Aceita a forma curta `-y`. Fora de terminal ele é aceito e não faz nada, porque lá não há confirmação a pular. Num terminal ele tem um segundo efeito: um destino já ocupado no escopo de máquina deixa de virar pergunta e vira recusa, com saída 3, onde a linha sem `-y` teria perguntado e podido escrever. Quem levanta essa recusa é `--force`, e só ele.
</ParamField>

<ParamField name="--force" type="flag">
Sobrescreve um destino que já existe no escopo de máquina, sem perguntar. No escopo de repositório não tem efeito, porque lá o `git status` já revela e desfaz. Aceita a forma curta `-f`.
</ParamField>

<ParamField name="--global" type="flag">
Escreve sob o diretório do usuário em vez do repositório atual. Aceita a forma curta `-g`.
</ParamField>
