Paramètres en session

Exécutez /settings pour changer l'apparence et le comportement de Kiro — couleurs, raccourcis clavier, saisie multiligne, bascules d'affichage, 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, features et history.

Tous les menus de paramètres partagent les mêmes commandes. Les touches Haut et Bas déplacent la sélection entre les rangées. Gauche modifie une bascule ou un cycle dans l'autre sens. Droite et Entrée activent ou font défiler une valeur, sélectionnent une option de type bouton radio ou ouvrent une rangée de navigation, et Entrée exécute aussi les rangées d'action. Échap ferme le menu de premier niveau ou revient depuis un sous-menu. Ces commandes s'appliquent à /settings, Display, Status line, Theme et /verbosity. Dans /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
• Afficher le raisonnement (chat.showThinking) — lorsque désactivé, masque les blocs de raisonnement de l'agent dans la sortie du clavardage
• Ligne d'état — choisissez si la ligne d'état affiche la date, l'heure, le pourcentage d'utilisation actuel et les crédits restants. Ces segments optionnels sont masqués par défaut. Les changements prennent effet immédiatement et persistent entre les sessions
• Titre du terminal — lorsqu'activé, définit le titre de la fenêtre du terminal à partir d'un nom personnalisé que vous fournissez avec /title. Activez-le depuis /settings display
• Conserver l'historique du terminal : lorsqu'activé, garde cet historique accessible lors des débordements et des réaffichages liés au redimensionnement

Les changements d'animations, d'art ASCII, d'icônes et de ligne d'état prennent effet immédiatement. La bascule Afficher le raisonnement 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.

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 V3, Workflows : outil de sous-agent apparaît directement sous la bascule Workflows. Ce paramètre est activé par défaut, afin que le clavardage principal puisse déléguer directement à des sous-agents ou par l'intermédiaire des Workflows. Désactivez-le pour faire des Workflows la seule voie de délégation du clavardage principal; les étapes de workflow peuvent toujours utiliser des sous-agents lorsque leur configuration d'agent le permet. Ce choix est enregistré sous chat.enableMainAgentSubagentTool et s'applique 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.

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.

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 false

# Show reasoning blocks again
kiro-cli settings chat.showThinking true

Quelques points à connaître :

• Le paramètre est réservé au démarrage. Les changements s'appliquent à votre prochaine session de clavardage, pas à la session actuelle.
• 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+O pour 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.

Tous les changements effectués via /settings sont enregistrés dans ~/.kiro/settings/cli.json et s'appliquent aux sessions futures. Vous pouvez aussi modifier ce fichier directement avec kiro-cli settings open.

Vos sélections /model et /effort persistent automatiquement. Changez de modèle ou modifiez le niveau d'effort de raisonnement une fois, et Kiro reporte cette préférence dans les sessions futures — vous n'avez plus besoin d'exécuter /model set-current-as-default pour qu'une sélection soit conservée.

Ces préférences sont écrites dans ~/.kiro/settings/cli.json, le même fichier utilisé pour les autres paramètres de la CLI. Les valeurs d'effort par défaut par 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