Comandos

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

A forma da linha, com os seletores que se misturam livremente e o plano que roda sempre na mesma ordem.

Antes de qualquer comando isolado, duas coisas valem para todos eles. Esta página é o que vem antes das quatro páginas ao lado, que saem do contrato de superfície e não desta prosa.

Os seletores se compõem

--ai-framework, --bundle, --skill e --mcp são seletores, flags que nomeiam do que a linha trata. Cada um aceita valor separado por vírgula, a flag repetida, ou as duas coisas, e eles acumulam em vez de sobrescrever.

overpower install --skill uma-skill --skill outra-skill --bundle api-python,outro-bundle

Misturar seletores de tipos diferentes numa única linha de install é o caso normal, não o caso de borda. --ai-framework matt-pocock --skill outra-skill --mcp cloudflare --runtime claude-code é uma invocação comum, e não três comandos costurados.

O --runtime naquela linha não é enfeite. Skill e servidor MCP juntos exigem o runtime nomeado, e a recusa vem antes de qualquer consulta ao catálogo ou ao disco:

a skill and an MCP server on one line need --runtime named explicitly,
or two separate commands, one per class

A razão é que as duas classes escrevem em tabelas diferentes, e nem todo runtime está nas duas. Sem o runtime na linha, o assistente teria de abrir dois passos com formas diferentes ao mesmo tempo, e ele é um gesto só. Saída 2.

O list é o único lugar onde isso não vale. Ele responde sobre um item só, então mais de um seletor numa linha de list é uma pergunta com duas respostas, e o comando recusa em vez de escolher uma calado.

O plano roda numa ordem fixa

Quando uma linha resolve para escritas em mais de uma unidade, um framework e uma skill avulsa no mesmo install, por exemplo, as escritas acontecem sempre na mesma ordem. Ela não é a ordem em que você digitou as flags.

Ordem	Unidade	Por que aqui
1	AI Framework	a unidade mais ampla, e a menos específica
2	Bundle	mais específico que um framework, menos que um artefato
3	Artefato avulso	você o nomeou diretamente, então ele vence
4	Servidor MCP	não é cópia, é enxerto, e cai em documento seu

A ordem importa mais onde duas seleções aterrissariam no mesmo destino. Em vez de levantar erro por essa sobreposição, a ordem fixa a decide: a unidade mais específica é escrita por último, então o conteúdo dela é o que sobrevive em disco.

overpower install --ai-framework matt-pocock --skill panlabs-python-standards --runtime claude-code

O assistente abre a lacuna, não a tela

Num terminal, uma linha de install que não fecha um plano abre o assistente em vez de recusar. O gatilho é a lacuna, e não a linha vazia: basta faltar o que instalar, ou faltar o runtime.

Ele abre só os passos que a sua linha deixou em aberto, sempre nesta ordem:

1. Artefatos

   O que instalar. Só abre quando a linha não nomeou nenhum artefato, framework, bundle ou servidor MCP.

2. Escopo

   Projeto ou máquina. Só abre quando a linha não trouxe --runtime nem --global, porque o escopo é o que decide o conjunto que o passo seguinte oferece.

3. Runtimes

   Quem recebe. Vem pré-marcado com o que a ferramenta encontrou no disco.

4. Confirmação

   O plano inteiro, antes do primeiro byte.

O que ele coleta vira exatamente a mesma requisição que a linha digitada à mão teria montado. --dry-run, --force e --yes não são passos e atravessam a sessão intactos.

Sair de qualquer passo aborta tudo, e não volta ao passo anterior. Nada é escrito, e a saída é 1. É a mesma forma tudo-ou-nada da confirmação final.

Fora de terminal o assistente nunca abre: a mesma linha incompleta cai nos mesmos dois erros de sempre e sai 2. É isso que faz uma invocação parcial num cano falhar cedo, em vez de pendurar esperando resposta.

As quatro páginas ao lado

overpower, list, install e doctor são geradas do contrato de superfície de comando, e nenhuma delas é escrita à mão. O que você lê nelas é a projeção do contrato: as opções, os códigos de saída e a linha de uso do painel saem todos do mesmo JSON, e é por isso que elas não podem divergir da tabela acima sem que a divergência apareça no diff de quem mexeu no contrato.

Esta página é a exceção da seção, e ela é a exceção de propósito: ela é a única folha autoral aqui, e o painel direito não existe nela. As quatro irmãs pintam o painel a partir de api_exemplos; esta passa pela perna do comutador que apenas delega, e o contraste entre as duas fica na mesma seção, a um clique de distância.