CLI · Interazione e input

Guida aggiornata del team Kimi Code

La TUI comprende campo di input, conversazione e barra di stato. Enter invia; Shift-Enter o Ctrl-J va a capo. A campo vuoto ↑/↓ sfoglia la cronologia della directory corrente, inclusi i comandi shell. Durante l’output Ctrl-C o Esc interrompe il turno senza uscire.

Incollare immagini e video

Incolla schermate, mockup, diagrammi e video dimostrativi: macOS/Linux: Ctrl-V; Windows: Alt-V. Un segnaposto modificabile viene sostituito con il contenuto all’invio. Il testo semplice viene incollato normalmente. Il modello deve supportare image_in/video_in; l’accesso Kimi Code abilita queste capacità per impostazione predefinita. Oltre 20 MB, i media più vecchi vengono esclusi dalle richieste con un avviso.

Comandi slash e riferimenti ai file

/ apre il completamento filtrato durante la digitazione; Esc lo chiude. Il testo senza corrispondenza viene inviato come messaggio normale. Le Agent Skills attive appaiono come /skill:<name>. @ completa percorsi relativi e fornisce il contenuto al modello. Funziona con o senza Git, include percorsi nascosti ma esclude .git; le cartelle terminano con /. Mentre lo strumento rapido si scarica, viene usata una scansione del filesystem. @ fornisce contesto, / richiama funzioni o Skills.

Approvazioni e permessi

Per azioni con effetti compare un pannello. Scegli con frecce e Enter o direttamente 1/2/3; rifiuta con Esc, Ctrl-C o Ctrl-D. L’approvazione per la sessione autorizza le chiamate analoghe fino alla fine. Le regole permanenti sono in permission. Le chiamate ordinarie in Ask When Needed e la scrittura dei file di piano in Plan non richiedono approvazione.

Always Ask (prima Manual) è predefinito: letture automatiche, conferma per ogni modifica o comando. Ask When Needed (prima YOLO), via /yolo, approva strumenti ordinari ma chiede per file sensibili (.env, chiavi SSH), comandi pericolosi e uscita da Plan; l’Agent può porre domande. Never Ask (prima Auto), via /auto, approva tutto, anche file sensibili e uscita da Plan, senza domande. shutdown, reboot e rm -rf richiedono conferma nei primi due modi, ma in Never Ask vengono eseguiti senza interruzioni.

Modalità Plan

Shift-Tab o /plan richiede un piano prima di modificare file. Puoi approvarlo, rifiutarlo o richiedere modifiche. /plan clear lo cancella quando inattiva. Uscire da Plan richiede conferma anche con Ask When Needed; Never Ask approva automaticamente e mostra “Auto-approved”.

Modalità shell

Digita ! a campo vuoto o incolla un comando che inizia con !. Il bordo viola e ! a sinistra indicano il modo. L’output entra nel contesto della conversazione. Backspace/Esc a campo vuoto esce; anche inviare il comando torna al modo normale. Ctrl+B manda il comando attivo in background; ↑ richiama comandi precedenti restando in shell. Output lunghi completati si comprimono; Ctrl-O li espande insieme agli strumenti. Ad esempio !gh auth login accede alla CLI GitHub senza altro terminale.

Modalità Obiettivo

Un obiettivo definisce un risultato verificabile in più turni, come correggere test falliti. Per domande singole usa un prompt normale. Dopo /goal specifica risultato e condizione di arresto (massimo 4000 caratteri; input più lungo viene rifiutato e resta modificabile):

Text

Obiettivi vaghi come trovare tutti i bug possono bloccarsi subito o durare troppo. Quelli chiaramente impossibili, come dimostrare che 1 + 1 = 3, vengono immediatamente segnati come bloccati.

Un obiettivo termina come completato (raggiunto, rimosso e riepilogato), in pausa (azione utente, interruzione o errore) o bloccato (con spiegazione). Il budget di tempo scorre solo con obiettivo attivo e sessione aperta. Chiudere o sospendere ferma il timer; /goal resume usa il tempo residuo. La barra sotto la conversazione web permette pausa, ripresa, annullamento e dettagli, incluso il budget di token configurato.

/goal next <objective> accoda altri obiettivi senza interrompere quello attuale. Restano invisibili all’Agent fino al completamento; poi il primo parte automaticamente. /goal next manage permette di riordinarli (↑/↓, Space seleziona, E modifica, D elimina, Esc annulla). Non partono se l’obiettivo corrente è in pausa, annullato o bloccato. In manual, l’obiettivo può fermarsi per approvazioni. La modalità non interattiva supporta solo la creazione: kimi -p "/goal ..."; codici di uscita 0 completato, 3 bloccato, 6 in pausa.

Output in corso ed editor esterno

L’input resta utilizzabile: Ctrl-S lo inserisce nel turno, Esc/Ctrl-C interrompe, Ctrl-O comprime/espande output e riepiloghi. Se l’Agent attende attività con WaitFor, Ctrl-S termina l’attesa anticipatamente senza fermare le attività o perdere i risultati. Gli altri strumenti in primo piano nello stesso gruppo devono prima terminare.

Ctrl-G apre il testo nell’editor esterno. Salvare e chiudere aggiorna l’input; chiudere senza salvare mantiene l’originale. Priorità: configurazione /editor → $VISUAL → $EDITOR. Se non è definito nulla, scegli prima un editor con /editor.