Paramètres

Kiro CLI offre une personnalisation approfondie grâce aux paramètres. Vous pouvez configurer tout, de la télémétrie au comportement du clavardage, en passant par les raccourcis clavier et les bascules de fonctionnalités.

Gérez les paramètres directement depuis la ligne de commande. Les paramètres enregistrés dans les menus interactifs /settings sont également accessibles avec kiro-cli settings; les deux interfaces utilisent les paramètres CLI stockés dans ~/.kiro/settings/cli.json.

# List all configured settings
kiro-cli settings list

# List all available settings with descriptions
kiro-cli settings list --all

# View a specific setting
kiro-cli settings telemetry.enabled

# Set a setting
kiro-cli settings telemetry.enabled true

# Delete a setting
kiro-cli settings --delete chat.defaultModel

# Open settings file in editor
kiro-cli settings open

Sans indicateur de portée, kiro-cli settings écrit ou supprime les paramètres globaux dans ~/.kiro/settings/cli.json. Passez --workspace pour stocker plutôt une valeur pour le projet en cours :

# Set a global default
kiro-cli settings --global chat.defaultAgent default

# Override it in the current workspace
kiro-cli settings --workspace chat.defaultAgent my-project-agent

Lorsque les deux portées définissent un paramètre remplaçable par espace de travail, la valeur de l'espace de travail a priorité dans les sessions de l'interface utilisateur du terminal de ce projet. Supprimez la valeur de l'espace de travail pour faire réapparaître la valeur globale. Certains paramètres sont globaux seulement — notamment chat.agentEngine, chat.uiMode et chat.terminalTitle — et ne peuvent pas être remplacés par espace de travail.

Dans Kiro CLI 3.1.0 ou une version ultérieure, sous macOS et Linux, un fichier appartenant à root et désigné par la variable d'environnement KIRO_DEFAULT_SETTINGS fournit des valeurs par défaut sous les deux portées. Toute valeur de votre cli.json global ou d'espace de travail la remplace. Consultez Variables d'environnement.

# Plain text (default)
kiro-cli settings list

# JSON
kiro-cli settings list --format json

# Formatted JSON
kiro-cli settings list --format json-pretty

Ces paramètres contrôlent la façon dont l'interface terminal affiche la sortie. Vous pouvez basculer les animations, l'art ASCII, les icônes, la prise en charge des lecteurs d'écran et l'affichage du raisonnement depuis une session avec /settings display.

L'interface terminal affiche un indicateur d'activité pendant que Kiro travaille. Définissez chat.enableCustomSpinnerVerbs à true pour utiliser l'ensemble de verbes défini dans chat.spinnerVerbs.

Exécutez kiro-cli settings open, puis ajoutez les propriétés suivantes à l'objet de niveau supérieur de ~/.kiro/settings/cli.json sans remplacer les paramètres existants :

{
  "chat.enableCustomSpinnerVerbs": true,
  "chat.spinnerVerbs": {
    "mode": "append",
    "verbs": [
      "Checking...",
      "Reading documentation <https://docs.example.com>"
    ]
  }
}

Utilisez append pour ajouter vos verbes à l'ensemble intégré de Kiro. Utilisez replace pour utiliser uniquement vos verbes. Une liste replace vide revient à l'indicateur d'activité intégré. Un verbe peut se terminer par un espace suivi d'une URL http ou https entre chevrons. Kiro affiche le texte du verbe et en fait un hyperlien de terminal lorsque le terminal prend en charge les hyperliens.

Ces raccourcis clavier s'appliquent uniquement à l'interface classique et n'ont aucun effet dans l'interface terminal.

Remplacez les raccourcis de l'interface terminal pour annuler une réponse, fermer les menus superposés, quitter la session et ouvrir la visionneuse de diagrammes. Les valeurs utilisent les modificateurs ctrl+, shift+ et alt+/meta+ avec une seule touche (par exemple ctrl+shift+q, esc). Les valeurs invalides reviennent au raccourci par défaut intégré.

V3 charge les outils MCP à la demande par défaut. Il lit les valeurs toolSearch.* enregistrées lors des exécutions interactives. Kiro CLI 2.31.1 et les versions ultérieures les appliquent aussi aux exécutions V3 non interactives. V2 reste à activer explicitement. Consultez Tool Search pour les détails.

Les échecs de requête transitoires — limitation, erreurs 5xx et interruptions de connexion (y compris les réinitialisations en cours de flux) — sont automatiquement retentés avec un délai croissant; aucun paramètre n'est requis.

# Enable telemetry
kiro-cli settings telemetry.enabled true

# Set default chat model
kiro-cli settings chat.defaultModel "claude-sonnet-4.6"

# Disable greeting message
kiro-cli settings chat.greeting.enabled false

# Enable knowledge base
kiro-cli settings chat.enableKnowledge true

# Set file patterns to include
kiro-cli settings knowledge.defaultIncludePatterns '["*.py", "*.js", "*.md", "*.txt"]'

# Set file patterns to exclude
kiro-cli settings knowledge.defaultExcludePatterns '["*.log", "node_modules", ".git", "*.pyc"]'

# Set maximum files to index
kiro-cli settings knowledge.maxFiles 2000

# Enable thinking tool
kiro-cli settings chat.enableThinking true

# Enable tangent mode
kiro-cli settings chat.enableTangentMode true

# Enable todo lists
kiro-cli settings chat.enableTodoList true

# Enable checkpoints
kiro-cli settings chat.enableCheckpoint true

# Configure key bindings
kiro-cli settings chat.tangentModeKey "t"
kiro-cli settings chat.delegateModeKey "d"

# Cap streaming responses at 10 minutes instead of the 60-minute default
kiro-cli settings api.timeout 600

# Give slow connections more room before a stall warning
kiro-cli settings api.streamIdleSoftTimeout 120

# Adjust knowledge base chunk size
kiro-cli settings knowledge.chunkSize 1024

# Disable auto-compaction for long conversations
kiro-cli settings chat.disableAutoCompaction true

Valeurs booléennes : Utilisez true ou false (minuscules)

kiro-cli settings telemetry.enabled true  # ✓ Correct
kiro-cli settings telemetry.enabled True  # ✗ Wrong

Valeurs de tableau : Utilisez le format JSON avec des guillemets simples

kiro-cli settings knowledge.defaultIncludePatterns '["*.py", "*.js"]'  # ✓ Correct

Valeurs de chaîne : Utilisez des guillemets pour les chaînes contenant des espaces

kiro-cli settings chat.defaultModel "claude-sonnet-4.6"  # ✓ Correct

Supprimez des paramètres individuels :

kiro-cli settings --delete setting.name

Ouvrez le fichier de paramètres pour une modification manuelle :

kiro-cli settings open

Consultez les paramètres actuels pour identifier les problèmes :

kiro-cli settings list --all

Si le fichier de paramètres devient corrompu :

1. Sauvegardez les paramètres actuels :

   bash

   kiro-cli settings list --format json > backup.json
   

2. Ouvrez le fichier de paramètres :

   bash

   kiro-cli settings open
   

3. Vérifiez la syntaxe JSON ou restaurez à partir de la sauvegarde

Les paramètres sont stockés dans ~/.kiro/settings/cli.json.

Vous pouvez modifier ce fichier directement, mais il est recommandé d'utiliser les commandes kiro-cli settings pour la validation.

• Configurer des agents personnalisés
• Workflows
• Configurer des serveurs MCP
• Configurer des outils de diff personnalisés
• Activer les fonctionnalités expérimentales
• Référence des commandes CLI