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 chat, en passant par les raccourcis clavier et les bascules de fonctionnalités.

Gérez les paramètres directement depuis la ligne de commande :

# 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

# 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 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 sous forme d'hyperlien dans les terminaux qui prennent 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 et quitter la session. 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é.

Configurez la découverte à la demande des outils MCP. 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-3-sonnet"

# 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-3-sonnet"  # ✓ 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
• Configurer des serveurs MCP
• Configurer des outils de diff personnalisés
• Activer les fonctionnalités expérimentales
• Référence des commandes CLI