CLI · Interaction et saisie

Guide à jour de l’équipe Kimi Code

L’interface comprend le champ de saisie, la conversation et la barre d’état. Enter envoie, Shift-Enter ou Ctrl-J insère un saut de ligne. Champ vide, ↑/↓ parcourt l’historique du répertoire courant, y compris les commandes shell. Pendant une réponse, Ctrl-C ou Esc interrompt seulement le tour, sans quitter.

Coller des images et vidéos

Collez directement captures, maquettes, schémas ou vidéos de démonstration : macOS/Linux : Ctrl-V ; Windows : Alt-V. Un espace réservé modifiable est remplacé par le contenu lors de l’envoi. Le texte brut est collé normalement. Le modèle doit prendre en charge image_in/video_in ; ces fonctions sont activées par défaut avec une connexion Kimi Code. Au-delà de 20 Mo de médias, les plus anciens sont omis des requêtes avec un avertissement.

Commandes slash et fichiers

/ ouvre un menu filtré pendant la saisie ; Esc le ferme. Une saisie sans correspondance devient un message ordinaire. Les Agent Skills actifs sont disponibles sous /skill:<name>. @ complète les chemins relatifs et fournit le contenu au contexte du modèle. Fonctionne avec ou sans Git, inclut les chemins cachés sauf .git. Les dossiers finissent par /. Pendant le téléchargement de l’outil de recherche rapide, une analyse du système de fichiers est utilisée. @ fournit le contexte ; / appelle des fonctions ou Skills.

Autorisations

Pour une action modifiant l’environnement, un panneau demande confirmation. Choisissez avec les flèches et Enter ou directement 1/2/3. Esc, Ctrl-C ou Ctrl-D refuse. Une autorisation pour la session couvre les appels similaires jusqu’à sa fin. Les règles permanentes sont dans permission. Les appels ordinaires en Ask When Needed et l’écriture des fichiers de plan en mode Plan ne demandent pas d’autorisation.

Always Ask (anciennement Manual), par défaut : lectures automatiques, confirmation individuelle des modifications et commandes. Ask When Needed (anciennement YOLO), via /yolo : outils ordinaires automatiques, mais confirmation pour les fichiers sensibles (.env, clés SSH), les commandes dangereuses et la sortie du mode Plan. L’Agent peut encore poser des questions. Never Ask (anciennement Auto), via /auto : tout est approuvé automatiquement, y compris les fichiers sensibles et les sorties de Plan ; aucune question. shutdown, reboot et rm -rf exigent une confirmation dans les deux premiers modes, mais s’exécutent sans interruption en Never Ask.

Mode Plan

Shift-Tab ou /plan demande d’abord un plan, puis votre validation avant les modifications. Approuvez, refusez ou demandez une révision. /plan clear efface le plan au repos. Quitter le mode demande confirmation même avec Ask When Needed ; Never Ask approuve automatiquement et affiche « Auto-approved ».

Mode shell

Saisissez ! dans un champ vide ou collez une commande commençant par !. Une bordure violette et un ! à gauche signalent ce mode. Les sorties entrent dans le contexte de conversation. Champ vide, Backspace/Esc quitte le mode ; l’envoi d’une commande le quitte aussi. Ctrl+B déplace une commande active en arrière-plan. ↑ rappelle une commande en restant en mode shell. Les longues sorties terminées se replient ; Ctrl-O les déplie avec les sorties d’outils. Par exemple, !gh auth login connecte la CLI GitHub sans autre terminal.

Mode Objectif

Un objectif décrit un résultat vérifiable sur plusieurs tours, par exemple corriger des tests en échec. Une question ponctuelle se traite mieux avec un message ordinaire. Après /goal, précisez le résultat et la condition d’arrêt (4000 caractères maximum ; au-delà, le texte reste dans le champ pour correction) :

Text

Un objectif vague comme trouver tous les bugs du projet peut se bloquer immédiatement ou durer trop longtemps. Les objectifs manifestement impossibles, comme prouver que 1 + 1 = 3, sont marqués comme bloqués immédiatement.

Un objectif se termine comme achevé (résultat atteint, objectif effacé et résumé), en pause (action utilisateur, interruption ou erreur) ou bloqué (avec une explication). Le budget de temps ne s’écoule que lorsque l’objectif est actif et la session ouverte. Fermer ou suspendre arrête le compteur ; /goal resume reprend le budget restant. La barre d’objectif sous la conversation web propose pause, reprise, annulation et détails, dont le budget de tokens configuré.

/goal next <objective> met en file les objectifs suivants sans interrompre le travail. Ils restent invisibles à l’Agent jusqu’à l’achèvement de l’objectif actuel, puis le premier démarre automatiquement. /goal next manage permet de les réordonner (↑/↓, Space sélectionner, E modifier, D supprimer, Esc annuler). Rien ne démarre si l’objectif actuel est en pause, annulé ou bloqué. En mode manual, des autorisations peuvent interrompre le travail. Le mode non interactif permet seulement de créer un objectif : kimi -p "/goal ..." ; codes de sortie : 0 achevé, 3 bloqué, 6 en pause.

Sortie en cours et éditeur externe

La saisie reste disponible pendant l’exécution : Ctrl-S injecte le message, Esc/Ctrl-C interrompt, Ctrl-O replie ou déplie les sorties et résumés. Si l’Agent attend des tâches via WaitFor, Ctrl-S termine cette attente sans arrêter les tâches ni perdre les résultats. Les autres outils au premier plan du même lot doivent encore finir.

Ctrl-G ouvre le texte dans un éditeur externe. Enregistrer et fermer met à jour la saisie ; fermer sans enregistrer garde l’original. Priorité : configuration /editor → $VISUAL → $EDITOR. Si rien n’est défini, choisissez d’abord un éditeur avec /editor.