Exécutez /settings pour changer la façon dont Kiro répond ainsi que son apparence et son comportement — style de sortie, couleurs, raccourcis clavier, saisie multiligne, bascules d'affichage, niveau de détail des appels d'outils, bascules de fonctionnalités et portée de l'historique des requêtes — sans quitter votre session de clavardage. Exécutez /settings seul pour ouvrir le menu, ou passez directement à une sous-commande avec /settings <subcommand>.
Sous-commandes disponibles : theme, keybindings, terminal, display, output-details (Kiro CLI 3.2.1 ou une version ultérieure), features et history.
Tous les menus de paramètres partagent les mêmes commandes. Les touches Up et Down déplacent la sélection entre les rangées. Left modifie une bascule ou un cycle dans l'autre sens. Right et Enter activent ou font défiler une valeur, sélectionnent une option de type bouton radio ou ouvrent une rangée de navigation, et Enter exécute aussi les rangées d'action. Esc ferme le menu de premier niveau ou revient depuis un sous-menu. Ces commandes s'appliquent à /settings, Display, Output details, Status line, Theme et /verbosity. Dans Output details et /verbosity, Ctrl+X fait défiler l'aperçu entre masqué, mini et étendu.
Dans une session V3, exécutez /settings display et utilisez la rangée Style de sortie pour choisir la façon dont Kiro met en forme les réponses. Les styles offerts proviennent de l'agent actif à l'ouverture du menu Display, ce qui permet à un agent mis à niveau de proposer de nouveaux choix sans mise à jour de la CLI.
Votre sélection est enregistrée comme préférence globale chat.outputStyle et s'applique aux requêtes suivantes. Le choix de la valeur par défaut de l'agent supprime le remplacement global. Une valeur chat.outputStyle définie pour l'espace de travail continue d'avoir priorité; dans ce cas, la rangée affiche le style actif de l'espace de travail pendant que vous modifiez la valeur globale par défaut.
Personnalisez les couleurs utilisées pour la saisie des requêtes et le texte des réponses de l'agent. L'assistant de thème vous guide étape par étape dans la personnalisation — choisissez un thème de base, ajustez des éléments spécifiques, puis confirmez. L'aperçu en direct affiche une véritable sortie de conversation afin que vous voyiez exactement à quoi ressemble votre thème en pratique.
/settings theme
Le système de thème utilise des couleurs ANSI nommées, afin que vos personnalisations s'affichent correctement sur des terminaux ayant des palettes de couleurs différentes. Il revient à des couleurs ANSI sûres lorsque la détection des couleurs du terminal a une faible fiabilité.
Affichez la configuration actuelle des raccourcis clavier. Il s'agit d'une référence en lecture seule montrant toutes les liaisons configurables et leurs valeurs actuelles.
/settings keybindings
Pour changer les raccourcis clavier, utilisez la commande kiro-cli settings :
kiro-cli settings chat.keybindings.cancelStream "ctrl+x" kiro-cli settings chat.keybindings.closeMenu "ctrl+[" kiro-cli settings chat.keybindings.quit "ctrl+shift+q"
Consultez Raccourcis clavier (interface terminal) pour la référence complète.
Activez Shift+Enter et Option+Enter comme raccourcis de nouvelle ligne dans votre terminal. Si le fait d'appuyer sur Shift+Enter soumet actuellement votre requête au lieu d'insérer une nouvelle ligne, cette commande corrige le problème en détectant automatiquement votre terminal et en appliquant la configuration de raccourci clavier appropriée.
/settings terminal
Terminaux nécessitant une configuration (appliquée automatiquement par /settings terminal) :
- Terminal intégré de VS Code
- Alacritty
- Zed
- Apple Terminal
Terminaux avec prise en charge native (aucune configuration requise) :
- iTerm2
- Kitty
- Ghostty
- WezTerm
- Warp
Pour les terminaux qui ne prennent pas en charge la configuration automatique, Kiro affiche des instructions de contournement manuel.
Utilisateurs de tmux : Ajoutez les deux lignes suivantes à votre tmux.conf pour que Shift+Enter soit transmis correctement :
set -s extended-keys on set -as terminal-features 'xterm*:extkeys'
Basculez des fonctionnalités visuelles pour l'accessibilité ou selon vos préférences personnelles, à l'aide des commandes des menus ci-dessus.
/settings display
Bascules disponibles :
- Style de sortie (V3) — choisissez la façon dont Kiro met en forme les réponses; l'agent actif fournit les styles disponibles
- Animations (
chat.allowAnimations) — lorsque désactivé, les indicateurs de chargement et effets de brillance affichent des trames statiques au lieu de s'animer - Art ASCII (
chat.allowAsciiArt) — lorsque désactivé, remplace les points braille, les caractères de dessin de boîtes et les symboles Unicode par de l'ASCII simple - Icônes (
chat.allowIcons) — lorsque désactivé, masque les icônes d'indicateur d'état (●, ○, ⚠) en faveur d'étiquettes textuelles uniquement - Show thinking (
chat.showThinking) — avant Kiro CLI 3.2.1, lorsque désactivé, masque les blocs de raisonnement de l'agent dans la sortie du clavardage. Dans Kiro CLI 3.2.1 ou une version ultérieure, cette rangée a été déplacée vers Output details - Ligne d'état — choisissez si la ligne d'état affiche la date, l'heure, le pourcentage d'utilisation actuel, les crédits restants et, dans Kiro CLI 3.1.0 ou une version ultérieure, Session credits, soit les crédits utilisés jusqu'ici par la session en cours. Ces segments optionnels sont masqués par défaut. Les changements prennent effet immédiatement et persistent entre les sessions
- Titre du terminal (
chat.terminalTitle) — lorsqu'activé, définit le titre de la fenêtre du terminal à partir d'un nom que vous donnez avec/title; sinon, à partir du titre de la session ou, si la session n'en a pas, du nom du dossier de l'espace de travail. Dans Kiro CLI 2.33 ou une version ultérieure, une session V3 affiche le titre de sa session; avant la version 2.33, une session V3 utilisait plutôt le nom du dossier de l'espace de travail. Désactivé par défaut et global seulement. Pour confirmer qu'il est activé, exécutez/title: lorsque la fonctionnalité est désactivée,/titlesignale qu'elle est désactivée et indique comment l'activer - Conserver l'historique du terminal : lorsqu'activé, garde cet historique accessible lors des débordements et des réaffichages liés au redimensionnement
- Lecteur d'écran (
chat.screenReader) : interface utilisateur complète du terminal seulement. Choisissezauto(par défaut),onouoff. Consultez Prise en charge des lecteurs d'écran
Les changements d'animations, d'art ASCII, d'icônes et de ligne d'état prennent effet immédiatement. Avant Kiro CLI 3.2.1, la bascule Show thinking est réservée au démarrage — elle persiste immédiatement, mais le changement s'applique à votre prochaine session de clavardage. Consultez Affichage du raisonnement ci-dessous.
Dans Kiro CLI 3.2.1 ou une version ultérieure, choisissez le niveau de détail affiché par les appels d'outils dans la transcription. Sélectionnez Output details dans /settings, ou exécutez directement la sous-commande. /settings verbosity ouvre toujours le même menu, et /verbosity seul ouvre son sélecteur de densité lorsqu'un préréglage est actif.
/settings output-details
Le menu comporte les rangées suivantes :
- Density preset — choisissez
collapsed(une ligne par appel d'outil : titre, durée et état),lean(arguments en ligne, sans raisonnement),defaultoufull(tout ce que voit l'agent, avec tous les filtres de sortie activés et sans troncature), ou custom pour régler une à une les rangées ci-dessous - Tool calls — arguments d'outils désactivés, dans le titre, en ligne ou en bloc, avec le raisonnement de l'agent et le temps écoulé activés ou désactivés
- Subagent — étapes des sous-agents, instructions des étapes, étiquettes de rôle des étapes et sortie complète. Dans une session V2, une bascule Show response summary apparaît aussi; une session V3 affiche toujours la réponse
- Thinking —
expanded,collapsedouoffpour les blocs de raisonnement de l'agent. Le choix est aussi enregistré danschat.showThinking - Task list — afficher ou masquer la liste des tâches
- Show output — les catégories d'outils dont la sortie reste dans la transcription
- Truncation — plafonds de lignes et de caractères pour les arguments et la sortie
Ajoutez un nom de section pour l'ouvrir directement, par exemple /settings output-details truncation. Esc revient à /settings.
Ces paramètres s'appliquent aux appels d'outils terminés. Un appel d'outil en attente de votre approbation affiche toujours tous ses arguments, et une approbation d'écriture de fichier affiche toujours sa diff complète, quels que soient le préréglage ou les plafonds choisis.
Les changements faits dans Output details s'appliquent à la session en cours. Une valeur définie en ligne de commande avec kiro-cli settings chat.showThinking <mode> s'applique au prochain démarrage de session, sauf si un enregistrement Output details sauvegardé par une version antérieure conserve encore sa propre valeur de raisonnement; changer une fois l'affichage du raisonnement dans Output details la remplace.
Dans l'interface utilisateur complète du terminal, la prise en charge des lecteurs d'écran permet à un lecteur d'écran de suivre les réponses de Kiro. Pendant qu'une réponse est diffusée et que votre requête est vide, le curseur masqué du terminal suit le texte de la réponse. Lorsque vous commencez à taper, ouvrez un menu ou répondez à une approbation, le curseur revient à cette saisie.
- auto (par défaut) : Kiro vérifie une seule fois si VoiceOver est en cours d'exécution sur votre Mac local, habituellement au démarrage ou lorsque vous ouvrez
/settings display. Par SSH ou une autre connexion à distance, sur les autres plateformes, ou lorsque la vérification échoue ou prend trop de temps, la prise en charge reste désactivée. Choisissez on dans ces cas. - on : toujours active.
- off : jamais active.
Lorsque la prise en charge est active, la saisie IME peut apparaître à une position différente. Le paramètre est global seulement. Pour le remplacer pour un seul lancement, définissez KIRO_SCREEN_READER à auto, on ou off :
KIRO_SCREEN_READER=on kiro-cli chat
Dans Kiro CLI 3.3.0 ou version ultérieure, une session V3 affiche une entrée Compaction dans le menu /settings. Elle n'a aucune sous-commande; exécutez /settings et ouvrez Compaction. L'écran comporte trois lignes :
- Automatic compaction — activez ou désactivez la compaction automatique pour les sessions que vous démarrez ou chargez à partir de maintenant. Le choix est enregistré sous
chat.disableAutoCompaction; lorsqu'un fichier.kiro/settings/cli.jsond'espace de travail définit cette clé, la ligne l'indique et la valeur de l'espace de travail reste en vigueur dans celui-ci - Current session — le seuil qu'utilise la session en cours, tel que le harnais d'agent l'a confirmé
- Global default — ouvrez l'éditeur de seuil. Tapez un pourcentage d'utilisation du contexte comportant au plus deux décimales, utilisez les touches fléchées pour l'ajuster ou appuyez sur
dpour suivre la valeur par défaut du harnais d'agent. L'éditeur affiche la plage acceptée et la valeur par défaut. La valeur est enregistrée souscompaction.autoCompactionThresholdet s'applique à la prochaine session que vous démarrez ou chargez; une valeurcli.jsond'espace de travail la remplace pour cet espace de travail
L'entrée n'apparaît pas lorsque le harnais d'agent ne prend pas en charge un seuil configurable. Consultez Compaction pour la référence des paramètres.
Activez les fonctionnalités d'agent disponibles pour votre compte dans les futurs processus Kiro CLI.
/settings features
Activez Workflows pour afficher les commandes des workflows déclaratifs et leurs commandes d'exécution. Ce choix est enregistré sous chat.enableWorkflows. Quittez et redémarrez Kiro CLI après l'avoir modifié; le processus actuel n'ajoute ni ne supprime dynamiquement les commandes de workflow.
Lorsque les Workflows sont activés dans Kiro CLI 2.34 ou une version ultérieure, Utilisation des workflows apparaît sous la bascule Workflows. Choisissez la fréquence à laquelle Kiro lance un workflow depuis le clavardage principal :
- Uniquement sur demande (par défaut) — Kiro lance un workflow uniquement lorsque vous en demandez un.
- Uniquement pour les tâches d'envergure — Kiro peut en lancer un pour du travail en plusieurs étapes ou qui nécessite plus de contexte.
- Autant que possible — Kiro tente de faire passer par les Workflows la plupart des tâches de lecture de code, d'implémentation, de test et de révision.
Ce choix est enregistré sous chat.workflowLaunch. Il s'applique à la session actuelle lorsque c'est possible, puis aux nouvelles sessions.
Si Workflows ne s'affiche pas, cette fonctionnalité n'est pas disponible pour votre compte. Consultez Workflows pour les recettes, les commandes et le comportement des exécutions.
Dans Kiro CLI 3.1.0 ou une version ultérieure, Session recap apparaît dans le même menu et est enregistré sous chat.enableSessionRecap. Démarrez une nouvelle session après l'avoir modifié.
- Disabled (par défaut) : Kiro n'effectue aucun appel de récapitulatif et n'affiche aucun récapitulatif.
- Enabled : Kiro effectue un appel de modèle facturé supplémentaire après chaque tour terminé; l'interface utilisateur complète du terminal affiche le récapitulatif au-dessus de la zone de saisie après trois secondes d'inactivité complète. Le mode Lite ne l'affiche pas, mais l'appel s'exécute tout de même tant que la fonctionnalité est activée.
Choisissez si l'historique des requêtes (le rappel par les flèches Haut/Bas dans la saisie) est suivi par session ou partagé entre toutes les sessions.
/settings history
Options :
- session (par défaut) — chaque session de clavardage conserve son propre historique des requêtes, donc Haut/Bas ne rappelle que les requêtes de la session actuelle
- global — toutes les sessions partagent un seul historique des requêtes
Le changement est écrit dans chat.historyMode et prend effet à votre prochaine session.
Lorsque l'agent raisonne sur une requête complexe, il peut diffuser ces blocs de raisonnement (« thinking ») en ligne au-dessus de sa réponse. Ceci est contrôlé par le paramètre chat.showThinking, qui est activé par défaut dans Kiro CLI 2.5.0 et versions ultérieures.
Dans Kiro CLI 3.2.1 ou une version ultérieure, réglez-le depuis Output details :
/settings output-details # Select "Thinking" and choose expanded, collapsed, or off
Avant Kiro CLI 3.2.1, basculez-le depuis le menu d'affichage :
/settings display # Select "Show thinking" and press Enter to toggle
Ou définissez-le directement depuis la ligne de commande :
# Hide reasoning blocks kiro-cli settings chat.showThinking off # Show reasoning blocks again kiro-cli settings chat.showThinking expanded
Les valeurs sont expanded, collapsed et off. true et false fonctionnent toujours et signifient collapsed et off.
Quelques points à connaître :
- Un changement en ligne de commande s'applique à votre prochaine session de clavardage, pas à la session actuelle. Dans Kiro CLI 3.2.1 ou une version ultérieure, un changement dans Output details s'applique à la session en cours.
- L'indicateur de chargement « Thinking... » en direct apparaît toujours pendant que l'agent traite votre requête, indépendamment de ce paramètre.
- Les longues traces de raisonnement se réduisent à une vue de fin. Appuyez sur
Ctrl+Opour développer ou réduire le bloc de raisonnement complet. - Les blocs de raisonnement apparaissent généralement pour les requêtes complexes à plusieurs étapes. Les requêtes simples peuvent n'en produire aucun.
Les préférences modifiées au moyen de /settings persistent d'une session à l'autre. La plupart sont enregistrées dans ~/.kiro/settings/cli.json, tandis que les préférences de thème sont enregistrées dans ~/.kiro/settings/kiro_cli_theme.json. Vous pouvez modifier directement le fichier de paramètres principal avec kiro-cli settings open.
Votre sélection /model s'applique uniquement à la session en cours. Pour enregistrer le modèle actuel comme valeur par défaut pour les sessions futures, exécutez /model set-current-as-default; Kiro enregistre la valeur par défaut dans ~/.kiro/settings/cli.json.
L'effort fonctionne différemment. Le choix d'un niveau dans le sélecteur /model le conserve pour ce modèle. L'utilisation directe de /effort <level> modifie uniquement la session en cours — exécutez ensuite /effort set-current-as-default pour l'enregistrer, ou choisissez plutôt le niveau dans /model. Dans V3, l'indicateur --effort s'applique uniquement à la session que Kiro démarre.
Les valeurs d'effort par défaut propres à chaque modèle se trouvent sous chat.modelDefaults. Consultez Effort pour la référence complète.
- Référence des paramètres — liste complète de tous les paramètres de la CLI
- Interface terminal — fonctionnalités et configuration de l'interface terminal
- Configuration — chemins et portées des fichiers de configuration
- Workflows — activer et exécuter des workflows déclaratifs
Paramètres en session