Comandos · Makuco

Referência de todos os comandos da CLI makuco. Para instalar a CLI, veja Instalação.

Comandos novos exigem a versão 3.1.0 ou superior

makuco unit sync, makuco skill add, makuco agent add e makuco prompt add só existem a partir da 3.1.0. Em versões anteriores esses comandos não são reconhecidos e a CLI sai com erro. Confira a sua versão com makuco --version e atualize antes de seguir:

makuco --version

Na 3.1.0 o conteúdo de unidade passa a vir do Makuco Hub — o caminho antigo de configuração de unidade por clone de repositório com chave SSH foi removido, sem coexistência.

Todos os comandos

Comando	O que faz	Desde
`makuco`	Abre a CLI interativa no projeto. Até a 3.1.0, mostrava só o banner.	3.2.0
`makuco run <skill> [alvo]`	Roda um turno de uma skill contra o agente, sem interface.	3.2.0
`makuco --version`	Mostra a versão instalada.	1.0.0
`makuco init`	Instala skills, agentes e MCPs no projeto. Interativo.	1.0.0
`makuco update`	Atualiza os ativos do pacote preservando o que você alterou.	2.0.0
`makuco unit sync`	Atualiza o conteúdo da unidade a partir do Hub, fora da inicialização.	3.1.0
`makuco skill add <endereço>`	Instala uma skill avulsa de qualquer unidade.	3.1.0
`makuco agent add <endereço>`	Instala um agente avulso de qualquer unidade.	3.1.0
`makuco prompt add <endereço>`	Instala um prompt avulso de qualquer unidade.	3.1.0

makuco mudou de significado na 3.2.0

O comando sem argumento deixou de imprimir um banner e passou a abrir uma interface no terminal, que dirige o fluxo Makuco de ponta a ponta. Ele exige um projeto já inicializado (.claude/ presente) e o Claude Code instalado. A referência completa — telas, comandos /, atalhos, modos e configuração — está em CLI Interativa.

Dois ciclos de atualização

Os ativos de um projeto Makuco vêm de duas origens, e cada uma tem o seu comando:

Origem	O que é	Comando que atualiza
Pacote da CLI	O que o `makuco init` instala: skills base, agentes, prompts, hooks, MCPs, `MAKUCO.md`.	`makuco update`
Makuco Hub	O conteúdo da unidade do seu time e os itens avulsos instalados com `skill`/`agent`/`prompt add`.	`makuco unit sync`

Rodar só o makuco update deixa o conteúdo da unidade parado. Quando há itens do Hub no projeto, o próprio update avisa quantos são e manda rodar o makuco unit sync.

Códigos de saída

Valem para o update, o unit sync e o skill/agent/prompt add:

Código	Significado
`0`	Sucesso — nada ficou pendente.
`1`	Falha — algum item não foi entregue.
`2`	Sucesso com pendência — sobrou decisão (item mantido, pulado, execução cancelada, ou registro não gravado).

O 2 existe por causa de CI: sem ele, um item que ficou como estava sairia 0 e o pipeline seguiria achando que instalou. Para não deixar pendência em automação, passe --policy.

O que vale para todos os comandos que gravam conteúdo

Nada é substituído sem cópia de segurança. O arquivo anterior vai para .makuco/backups/<AAAAMMDD-HHMMSS-mmm>/, e a pasta é garantida no .gitignore do projeto na primeira substituição — a cópia guarda o arquivo como você o deixou, e um git add . levaria conteúdo customizado para o repositório.
Item que você alterou abre decisão: manter o seu, substituir pelo da unidade, ver a diferença ou pular. Em terminal não interativo (CI) e sem --policy, a decisão é skip.
--policy decide sem perguntar: keep (mantém o seu) · accept (substitui pelo do Hub) · skip (deixa para a próxima execução).
Aviso antes de gravar conteúdo que executa código. Hooks e scripts vindos do Hub rodam com as suas permissões — a CLI lista os itens executáveis antes de gravar.
É preciso ter uma ferramenta de IA detectada no projeto (.claude/ ou .github/). Sem isso o comando recusa e manda rodar o makuco init.