Paramètres en session

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

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. Utilisez ↑↓ pour vous déplacer entre les bascules et ←→ ou Enter pour inverser celle sélectionnée.

/settings display

Bascules 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

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.

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