Makuco

Buscar na documentação

Páginas e seções

Atalhos

Teclado e mouse da CLI interativa, por tela.

O /help imprime a lista dos atalhos que estão montados agora — ela é gerada do próprio teclado da CLI, não escrita à mão. As tabelas abaixo são a mesma lista, organizada por tela.

Globais

TeclaO que faz
Ctrl-TMostra ou esconde a lateral, e grava a escolha.
Shift+TabAlterna entre o modo manual e o yolo.
Ctrl-YCopia a seleção do mouse via OSC 52.
Ctrl-CCancela o turno. Fora de turno, o segundo Ctrl-C sai da CLI.
Ctrl-DSai da CLI, com a caixa vazia.
EscCancela o que estiver rodando — quando nenhuma tela é dona do Esc.

Por que Shift+Tab e não Tab

Tab tem três donos: o autocomplete de comandos, o diálogo de commit e a própria caixa de texto. Uma camada global em Tab tomaria a tecla de todos os três — e o modo em questão autoriza o agente a rodar comando sem confirmar, o que não combina com a tecla mais reflexiva do terminal.

Conversa

TeclaO que faz
PageUp / PageDownRola a conversa uma página.
Ctrl-EndVolta ao fim e reengata o acompanhamento automático.
Ctrl-OAbre ou fecha a saída da última chamada de ferramenta.
Ctrl-↑ / Ctrl-↓Rolam a lateral, não a conversa.

Caixa de prompt e lista de comandos

Com a lista de comandos aberta (depois de digitar /), ela ganha de tudo:

TeclaO que faz
↑ / ↓Comando anterior / próximo.
TabCompleta o comando selecionado na caixa.
EnterRoda o comando selecionado.
EscFecha a lista — não cancela o turno.

HOME

TeclaO que faz
↑ / ↓Opção anterior / próxima.
1 … 3Ativa a opção pelo número.
EnterAtiva a opção em foco.
EscVolta ao menu, ou à conversa quando já existe uma.

Clique do mouse também ativa.

Diálogo de permissão

TeclaO que faz
↑ / ↓ / TabOpção anterior / próxima.
1 … nEscolhe a opção pelo número.
EnterConfirma a opção em foco.
EscCancela o pedido de permissão.

Wizard de perguntas

TeclaO que faz
Tab / → / lPróxima pergunta (aba).
Shift+Tab / ← / hPergunta anterior.
↑ / k · ↓ / jAlternativa anterior / próxima.
1 … nEscolhe a alternativa pelo número.
EspaçoMarca ou desmarca, em múltipla escolha.
EnterResponde, marca ou envia — depende de onde o cursor está.
EscPula a pergunta: o agente decide sozinho. Com o campo de texto aberto, fecha o campo.

Modais de escolha (/model, /theme)

TeclaO que faz
↑ / ↓Item anterior / próximo.
PageUp / PageDownRola a lista uma página.
EnterAplica e grava.
EscFecha sem aplicar — no tema, desfaz a pré-visualização.

Digitar filtra a lista.

/settings

TeclaO que faz
↑ / ↓Campo anterior / próximo.
← / →Valor anterior / próximo do campo em foco.
EnterAbre a escolha nos campos Modelo e Tema; nos outros, volta ao HOME.
EscFecha a configuração e volta ao HOME.

/workflow

TeclaO que faz
↑ / ↓Rola uma linha.
PageUp / PageDownRola uma página.
Home / EndTopo / fim da árvore.
EscFecha, sem cancelar o turno.

/skills

TeclaO que faz
↑ / ↓Skill anterior / próxima.
PageUp / PageDownRola uma página.
Home / EndTopo / fim da lista.
EnterPõe o comando da skill selecionada na caixa.
EscFecha, sem cancelar o turno.

Visualizador de arquivo

TeclaO que faz
↑ / ↓Rola uma linha.
PageUp / PageDownRola uma página.
Home / EndTopo / fim do arquivo.
mNo markdown, alterna entre o texto formatado e o fonte marcado.
EscFecha, sem cancelar o turno.

Diálogo de commit

TeclaO que faz
↑ / ↓Arquivo acima / abaixo.
EspaçoMarca ou desmarca o arquivo sob o cursor.
aMarca todos, ou desmarca todos.
TabAlterna entre a lista de arquivos e o campo de instruções.
EnterCommita os arquivos marcados.
EscFecha o diálogo, sem cancelar o turno.

Aviso de versão nova

TeclaO que faz
↑ / ↓Opção anterior / próxima.
EnterConfirma a opção em foco.
EscAdia a atualização e libera a execução corrente.

Mouse

O mouse funciona por padrão:

GestoO que faz
Passar sobre uma linha da lateralRealça a linha sob o ponteiro.
Clicar num arquivo da lateralAbre o visualizador.
Clicar em ▸ Fazer commitAbre o diálogo de commit.
Clicar numa opção do menu ou do wizardEscolhe direto.
Selecionar texto arrastandoCopia sozinho para o clipboard, com um cartão de aviso no canto superior direito.

Terminal que não anuncia suporte a OSC 52 recebe um aviso dizendo que a cópia não sai dali. MAKUCO_DISABLE_MOUSE=1 desliga o mouse por inteiro — o Ctrl-Y continua sendo a saída para copiar.

A seleção nativa do terminal não vale aqui

A CLI roda em tela cheia (alternate screen), então o terminal vê um quadro redesenhado, não linhas de texto. Quem seleciona e copia é a própria CLI, pelo OSC 52.