Comandos / · Makuco

Na caixa de prompt, uma linha que começa com / é comando. Qualquer outra linha vai como mensagem para o agente.

Digitando / a lista de comandos abre sozinha, filtrada por prefixo: ↑↓ escolhem, Tab completa na caixa, Enter roda, Esc fecha. Errou de letra? A CLI sugere o comando mais próximo em vez de só dizer "desconhecido".

Comandos embutidos

Comando	O que faz
`/help`	Lista os comandos, as skills do ambiente e os atalhos ativos.
`/steps`	Lista os passos candidatos. `/steps <n>` roda o n-ésimo.
`/next`	Roda o passo oferecido.
`/skip`	Deixa o passo oferecido de lado.
`/workflow`	Relê os artefatos e mostra a árvore completa. `Esc` volta.
`/skills`	Lista as skills do ambiente; `Enter` põe o comando na caixa, `Esc` volta.
`/usage`	Mostra o uso da licença e quando ele reseta.
`/clear`	Encerra a sessão e zera o contexto do agente.
`/home`	Volta ao menu de entrada.
`/flow`	Volta para a conversa.
`/model`	Abre a escolha de modelo. `/model <nome>` aplica direto.
`/theme`	Abre a escolha de tema, com pré-visualização enquanto você escolhe.
`/settings`	Configuração do projeto: provider, modelo, auto-aprovação, tema e lateral.
`/sidebar`	Mostra ou esconde a lateral, e grava a escolha.
`/yolo`	Liga ou desliga o modo em que os passos rodam sem pedir nada.
`/commit`	Escolhe arquivos e manda o agente commitar e empurrar.
`/exit`	Fecha a sessão e sai.

Aliases

Aceitos ao digitar, mas fora da lista de sugestões — uma porta por sala:

Alias	Equivale a
`/status`	`/workflow`
`/pbi`	`/home`
`/config`	`/settings`
`/uso`	`/usage`

Os quatro que dirigem o loop

/steps, /next, /skip e /workflow são os que mexem no laço da CLI.

/steps          → lista os candidatos derivados dos artefatos
/steps 2        → roda o segundo da lista
/next           → roda o que está sendo oferecido
/skip           → descarta a oferta e vai para a próxima
/workflow       → relê o disco e mostra o quadro inteiro

Decisão substitui decisão; texto se soma

Um /skip depois de um /next cancela o /next — a CLI não roda o passo que você acabou de pular. Já duas linhas de texto digitadas viram duas mensagens, na ordem. É a diferença entre "mudei de ideia" e "mandei duas frases".

`/clear` — o que ele encerra de verdade

/clear faz três coisas: encerra a sessão com o agente, limpa a conversa da tela e zera o contador de contexto da lateral.

O que ele não faz:

Não devolve cota da assinatura já gasta — o /usage continua onde estava.
Não reescreve o scrollback do terminal, que é do emulador.
Não roda em cima de um turno: com turno em curso ele recusa, porque fechar o transporte no meio de uma resposta penduraria o laço.

Sob --yolo, o /clear devolve o volante

Jogar o contexto fora é o gesto mais explícito de "pare" que a caixa oferece. Por isso o /clear é a única exceção ao yolo: o modo continua ligado, mas a CLI não abre outro processo na sequência — ela espera a sua próxima decisão.

Skills como comandos

Toda skill do ambiente com nome válido vira um comando. /makuco-desenvolver, /makuco-backend, /tlc-spec-driven — o nome é usado verbatim, sem prefixo e sem apelido curto.

/makuco-analisar
/makuco-desenvolver pbi_003
/makuco-code-review a branch atual contra a main

O texto depois do comando vira Instrução do usuário: no prompt.

As duas skills orquestradoras têm tratamento especial: /makuco-analisar e /makuco-desenvolver resolvem o alvo pelo estado do projeto quando você não diz qual é. Qualquer outra skill é invocada direto.

Quando o nome colide

Situação	O que acontece
A skill tem o nome de um comando embutido (ou de um alias)	O comando embutido ganha. A skill continua alcançável pela tela `/skills`.
Duas origens têm skill com o mesmo nome	Ganha a mais próxima do projeto: projeto > usuário > plugin.
O nome tem espaço ou barra	Não vira comando — resolveria só o primeiro pedaço. Alcançável pela tela `/skills`.

O /help lista as skills junto dos comandos. Acima de 10 skills ele resume por origem e manda usar o /skills, em vez de despejar 38 linhas no meio da conversa.