CLI · Interação e entrada

Guia atualizado da equipe Kimi Code

A TUI tem campo de entrada, conversa e barra de status. Enter envia; Shift-Enter ou Ctrl-J insere uma quebra de linha. Com o campo vazio, ↑/↓ percorre o histórico do diretório atual, incluindo comandos shell. Durante uma resposta, Ctrl-C ou Esc interrompe o turno sem sair do programa.

Colar imagens e vídeos

Cole capturas, layouts, diagramas e vídeos diretamente: macOS/Linux: Ctrl-V; Windows: Alt-V. Um marcador editável é substituído pelo conteúdo ao enviar. Texto simples é colado normalmente. O modelo precisa de image_in/video_in; essas funções são ativadas por padrão no login Kimi Code. Acima de 20 MB de mídia, os itens mais antigos são omitidos das solicitações com um aviso.

Comandos slash e referências a arquivos

/ abre um menu filtrado durante a digitação; Esc o fecha. Texto sem correspondência vira mensagem comum. Agent Skills ativas aparecem como /skill:<name>. @ completa caminhos relativos e fornece o arquivo ao contexto. Funciona com ou sem Git, inclui caminhos ocultos exceto .git; pastas terminam com /. Enquanto o buscador rápido baixa, é usada uma varredura do sistema de arquivos. @ fornece contexto; / chama funções ou Skills.

Aprovações e permissões

Ações com efeitos exibem um painel. Escolha com setas e Enter ou diretamente com 1/2/3; rejeite com Esc, Ctrl-C ou Ctrl-D. Aprovar para a sessão autoriza chamadas similares até seu fim. Regras permanentes ficam em permission. Chamadas normais em Ask When Needed e escrita de arquivos de plano em Plan não pedem aprovação.

Always Ask (antes Manual) é o padrão: leituras automáticas, confirmação individual para alterações e comandos. Ask When Needed (antes YOLO), via /yolo, aprova ferramentas comuns, mas pergunta sobre arquivos sensíveis (.env, chaves SSH), comandos perigosos e saída de Plan; o Agent ainda pode fazer perguntas. Never Ask (antes Auto), via /auto, aprova tudo, incluindo arquivos sensíveis e saída de Plan, sem perguntas. shutdown, reboot e rm -rf exigem confirmação nos dois primeiros modos, mas executam sem interrupção em Never Ask.

Modo Plan

Shift-Tab ou /plan produz primeiro um plano e espera sua revisão antes de alterar arquivos. Aprove, rejeite ou peça ajustes. /plan clear limpa o plano quando ociosa. Sair de Plan exige confirmação mesmo com Ask When Needed; Never Ask aprova automaticamente e registra “Auto-approved”.

Modo shell

Digite ! na entrada vazia ou cole um comando iniciado por !. A borda violeta e ! à esquerda indicam o modo. A saída entra no contexto da conversa. Backspace/Esc no campo vazio sai; enviar também retorna ao modo normal. Ctrl+B move um comando ativo para segundo plano; ↑ recupera comandos mantendo o modo shell. Saídas longas concluídas se recolhem; Ctrl-O as expande junto com ferramentas. Por exemplo, !gh auth login conecta a CLI GitHub sem outro terminal.

Modo Objetivo

Um objetivo define um resultado verificável em vários turnos, como corrigir testes com falha. Para perguntas pontuais, use um prompt normal. Após /goal, especifique resultado e condição de parada (até 4000 caracteres; entradas maiores são rejeitadas e permanecem editáveis):

Text

Objetivos vagos, como encontrar todos os bugs, podem bloquear imediatamente ou durar demais. Os claramente impossíveis, como provar que 1 + 1 = 3, são marcados como bloqueados imediatamente.

Um objetivo termina concluído (atingido, removido e resumido), pausado (por você, interrupção ou erro) ou bloqueado (com explicação). O orçamento de tempo só avança com o objetivo ativo e a sessão aberta. Fechar ou pausar para o relógio; /goal resume usa o tempo restante. A barra sob a conversa web permite pausar, retomar, cancelar e ver detalhes, incluindo o orçamento de tokens configurado.

/goal next <objective> enfileira objetivos sem interromper o atual. Ficam invisíveis ao Agent até sua conclusão; então o primeiro começa automaticamente. /goal next manage permite reorganizá-los (↑/↓, Space selecionar, E editar, D excluir, Esc cancelar). Não iniciam se o atual estiver pausado, cancelado ou bloqueado. Em manual, podem parar para aprovações. O modo não interativo só permite criar: kimi -p "/goal ..."; códigos de saída: 0 concluído, 3 bloqueado, 6 pausado.

Saída em andamento e editor externo

A entrada continua disponível: Ctrl-S injeta a mensagem, Esc/Ctrl-C interrompe e Ctrl-O recolhe ou expande saídas e resumos. Se o Agent espera tarefas via WaitFor, Ctrl-S encerra a espera antes, sem parar as tarefas nem perder resultados. Outras ferramentas em primeiro plano no mesmo grupo ainda precisam terminar.

Ctrl-G abre o texto no editor externo. Salvar e fechar atualiza a entrada; fechar sem salvar preserva o original. Prioridade: configuração /editor → $VISUAL → $EDITOR. Se nenhuma existir, escolha primeiro um editor com /editor.