Modos e permissões

Toda ação sensível do agente passa por você. O que muda entre os modos é quanto ele pergunta.

O diálogo de permissão

Quando o agente pede para rodar um comando, editar um arquivo ou buscar na rede, a CLI abre o diálogo com as opções que o próprio agente ofereceu — tipicamente permitir uma vez, permitir sempre, recusar uma vez, recusar sempre. Esc cancela o pedido.

O que é aprovado sozinho

Com Auto-aprovar seguras ligado (/settings ou autoApprove: true no config), a CLI aprova sem perguntar apenas o que é leitura local:

Classificação	Ações
Seguras — candidatas a auto-aprovação	`read`, `search`, `think`
Sensíveis — sempre perguntam	`edit`, `delete`, `move`, `execute`, `fetch`, `switch_mode`, e qualquer outra

Duas condições precisam valer ao mesmo tempo. Não basta a ação se declarar read: a ferramenta também precisa ser uma de leitura local reconhecida — Read, NotebookRead, Glob, Grep, LS. Qualquer outra — Bash, Write, WebFetch, um mcp__* — nunca é auto-aprovada, mesmo rotulada como leitura.

Buscar na rede é sensível, de propósito

fetch traz conteúdo de fora para o contexto do agente e pode levar conteúdo do projeto para fora. Não é leitura local, então pergunta.

Quando a CLI não sabe classificar — o agente não mandou o tipo, ou mandou um tipo desconhecido — ela pergunta. Nunca aprova no escuro.

Os três eixos

Eixo	Onde se liga	O que faz
Auto-aprovar seguras	`/settings` ou `autoApprove` no config	Aprova só as seguras da tabela acima. Persistente.
`--auto-approve`	Flag na linha de comando	Aprova todas as permissões, acima da política. Vale só nesta execução.
`--yolo` / `/yolo` / `Shift+Tab`	Flag ou runtime	Roda os passos sem pedir licença e aprova todas as permissões.

Modo yolo

O yolo é o modo em que a CLI não pergunta nada: ela encadeia os passos candidatos sozinha e aprova toda permissão. O teclado continua vivo — dá para acompanhar, cancelar, abrir /workflow e conversar.

makuco --yolo         # começa nele

Dentro da CLI, /yolo ou Shift+Tab ligam e desligam a qualquer momento. O estado aparece numa linha própria abaixo da caixa, nos dois valores — não só quando ligado.

O que o nome carrega

Ligado o yolo, o agente lê, escreve e roda comando sem confirmar nada. Desligar não interrompe o turno em curso; ele passa a valer da próxima decisão em diante.

O que continua parando o laço, mesmo no yolo

Situação	Comportamento	Por quê
A skill perguntou algo	Volta a esperar você	Aprovar ação não é responder pergunta. Inventar resposta em nome de quem não está lá é pior que parar.
Um passo falhou ao abrir	É estacionado, com aviso	Sem isso o laço seria infinito: o candidato que acabou de falhar voltaria a ser escolhido para sempre.
Acabaram os passos	A CLI fica ociosa	Fim dos passos é aviso, não fim de processo. Dali o teclado é seu.
Você deu `/clear`	Devolve o volante	Jogar o contexto fora é o "pare" mais explícito que a caixa oferece. O modo continua ligado.

Se você combinar `--auto-approve --yolo`

Desligando o yolo depois, o --auto-approve fica — ele veio da flag, não do modo.

A parada por alvo

Fora do yolo, quando um alvo fecha (uma feature analisada, um PBI implementado) a CLI para e pede licença antes de seguir para o próximo. A oferta aparece no placeholder da caixa e como uma dica na conversa; Enter com a caixa vazia aceita, /skip descarta.

Aceitar não custa um processo novo: alvo liberado na mesma skill continua na sessão viva.

`--auto` — o laço sem interface

makuco --auto

--auto roda cada passo sem pedir confirmação, mas troca de laço: sai da CLI persistente e entra no motor headless. Nele o teclado fica praticamente morto — não há chat, /skills nem /workflow, e o processo retorna quando os passos acabam.

--yolo vence --auto

Os dois pedem "não me pergunte", em laços diferentes. Passando os dois, vale o yolo — que é o mais específico e mantém o teclado vivo —, com um aviso na conversa dizendo que o --auto foi ignorado. Sem TTY não existe laço persistente para ligar, e o --yolo degrada para o motor headless com aprovação automática, em vez de virar um no-op silencioso.

Detalhe do caminho headless em Headless e CI.

Cancelar

Tecla	Quando	O que faz
`Esc`	Com algo rodando	Cancela o turno.
`Ctrl-C`	Com algo rodando	Cancela o turno.
`Ctrl-C` (duas vezes)	Fora de turno	Sai da CLI.
`Ctrl-D`	Com a caixa vazia	Sai da CLI.

"Algo rodando" inclui a abertura do turno — o processo do agente subindo, o handshake, a sessão sendo criada. É o intervalo em que a CLI parece ocupada antes da primeira palavra do agente aparecer, e as duas teclas valem ali também.

O cancelamento tem prazo

Pedido o cancelamento, a CLI espera 2 segundos pela confirmação do agente. Passado isso, ela mesma encerra o turno e derruba a sessão — um agente que não confirmou está num estado que não dá para ler, e esperar mais seria indistinguível de travar. Quem responde a tempo não paga nada: a sessão segue viva para o turno seguinte.

Cancelar é sobre o turno. A CLI continua de pé, com a conversa na tela e o teclado seu.