Telas

A CLI tem uma tela por vez na frente, mais uma coluna lateral opcional. Esc sai de qualquer visão sem cancelar o turno que estiver rodando.

HOME — a tela inicial

É o que abre quando você roda makuco num projeto. Não há caixa de texto aqui: só o menu, com o passarinho e o logo em cima e uma linha de status embaixo (provider · modelo · modo, mais pasta:branch e a versão).

Navegação: ↑↓ ou o dígito da opção, Enter ativa, clique do mouse também. Esc volta ao menu — ou à conversa, quando já existe uma.

Conversa

A tela principal. De cima para baixo: o histórico rolável, a caixa de prompt e a linha de modo.

O histórico mostra, em ordem:

• Mensagens do agente, com markdown renderizado.
• Chamadas de ferramenta, colapsáveis — Ctrl-O abre e fecha a saída da última.
• Diffs de cada arquivo editado, coloridos.
• Perguntas e respostas do wizard, e as permissões respondidas.
• Avisos da própria CLI (passo estacionado, flag ignorada, modelo que não resolveu).

A caixa de prompt aceita três coisas: um comando /, o nome de uma skill (/makuco-desenvolver alvo opcional) ou texto livre, que vai como mensagem para o agente.

Quando um alvo fecha e a CLI para para pedir licença, a oferta aparece no placeholder da caixa e como uma dica na conversa. Com a caixa vazia, Enter aceita; digitou o primeiro caractere, Enter volta a ser "enviar mensagem".

Rolagem

PageUp / PageDown rolam a conversa. Ctrl-End volta ao fim e reengata o acompanhamento automático.

Lateral

Coluna de 42 colunas à direita. Ela aparece sozinha acima de 120 colunas de terminal; abaixo disso, abre como sobreposição quando você pede (Ctrl-T ou /sidebar).

Ctrl-↑ / Ctrl-↓ rolam a lateral. A preferência (auto ou hide) é gravada em .makuco/config.yml quando você alterna por Ctrl-T ou /sidebar.

A árvore de arquivos

Os arquivos que o agente mexeu nesta sessão vêm primeiro, marcados com ●; o resto da árvore vem depois. O marcador também explica o contador ao lado:

• Linha marcada → +N -N é o diff líquido da sessão, o mesmo que o visualizador pinta de verde.
• Linha sem marca → +N -N é o diff contra o HEAD.

Arquivo binário sai como - -. Repositório sem commit nenhum sai sem contador.

Visualizador de arquivo

Clicar numa linha da árvore abre o arquivo em sobreposição:

• Código vai para o realce de sintaxe, com numeração de linha.
• .md abre formatado; m alterna para o fonte marcado.
• Linhas adicionadas ou alteradas na sessão ganham fundo verde e um filete no gutter. Linha removida não aparece — o histórico está no diff da conversa. Arquivo novo abre sem marcação.
• Conteúdo que o agente não tocou é lido do disco. Binário e arquivo grande demais dizem o que são em vez de despejar bytes no terminal.

Navegação: ↑↓, PageUp/PageDown, Home/End. Esc fecha, sem cancelar o turno.

/workflow — a árvore do projeto

Relê os artefatos do disco na hora — inclusive durante um turno — e desenha tudo: cada feature, o estado da análise dela e cada PBI com o estado de desenvolvimento.

No topo, a barra de progresso do projeto: cada feature conta uma unidade (a análise) mais uma por PBI. O alvo ativo já aparece visível na abertura.

Navegação: ↑↓, PageUp/PageDown, Home/End. Esc fecha sem cancelar o turno. /status é alias de /workflow.

/skills — o que existe para invocar

Enquanto o /workflow mostra o que a CLI derivou, o /skills mostra o que existe no disco para invocar. A lista cobre três origens, nesta ordem de precedência:

Enter escreve /nome na caixa de prompt, com o cursor no fim — não invoca na hora. É o que deixa você acrescentar o alvo antes de enviar. Enter de novo, sem digitar nada, invoca.

/usage — o consumo da assinatura

Abre o quadro de uso da sua licença do Claude: todas as janelas, cada uma com percentual, barra e o horário em que reseta. A janela que o servidor marca como vigente aparece com · em vigor.

Os rótulos são os mesmos do /usage do Claude Code — sessão atual, semana atual (todos os modelos), semana atual (Opus) — porque é a mesma cota vista por duas telas.

O /clear não zera esse número: sessão nova não devolve token já gasto. /uso é alias.

/settings — configuração do projeto

Cinco campos, gravados em .makuco/config.yml:

Navegação: ↑↓ troca de campo, Esc volta. Detalhe de cada valor em Configuração.

Os modais de escolha

Modelo e tema abrem o mesmo componente: título, filtro no topo, lista embaixo, o valor em vigor marcado com ● e já em foco. Esc fecha sem aplicar — no tema, isso desfaz a pré-visualização. /model e /theme abrem os mesmos modais direto.

Wizard de perguntas

Quando o agente faz uma pergunta estruturada, ela vira escolha na tela — não parágrafo no meio do texto.

• Uma aba por pergunta, rotulada pelo cabeçalho que o agente mandou, mais uma aba Confirmar com o resumo de tudo. Aba já respondida muda de cor.
• ←→ troca de aba, ↑↓ anda nas alternativas, Enter responde ou marca, Espaço marca em múltipla escolha.
• Esc pula a pergunta e o turno segue — o agente decide sozinho. Não cancela o turno.
• Dá para voltar numa aba já respondida e trocar a resposta antes de submeter.

Numa múltipla escolha, texto escrito e opções marcadas são mutuamente exclusivos: o protocolo descarta um dos dois, então a tela só oferece um.

Aviso de versão nova

Se houver versão mais recente publicada, um cartão aparece no arranque com Atualizar agora e Mais tarde. Escolhendo atualizar, a CLI se atualiza e reabre sozinha já na versão nova. Esc adia e libera a execução corrente.

A consulta ao canal nunca atrasa o arranque — ela corre enquanto a interface monta — e não acontece quando a CLI está rodando de um checkout do repositório.