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
| Paramètre | Type | Description | Exemple |
|---|---|---|---|
telemetry.enabled | boolean | Activer/désactiver la collecte de télémétrie | kiro-cli settings telemetry.enabled true |
telemetryClientId | string | Identifiant client pour la télémétrie | kiro-cli settings telemetryClientId "client-123" |
| Paramètre | Type | Description | Exemple |
|---|---|---|---|
chat.defaultModel | string | Modèle d'IA par défaut pour les conversations | kiro-cli settings chat.defaultModel "claude-3-sonnet" |
chat.defaultAgent | string | Configuration d'agent par défaut | kiro-cli settings chat.defaultAgent "my-agent" |
chat.diffTool | string | Outil de diff externe pour visualiser les changements de code (classique seulement) | kiro-cli settings chat.diffTool "delta" |
chat.greeting.enabled | boolean | Afficher le message d'accueil au démarrage du chat | kiro-cli settings chat.greeting.enabled false |
chat.editMode | boolean | Activer le mode d'édition Vi (classique seulement) | kiro-cli settings chat.editMode true |
chat.enableNotifications | boolean | Activer les notifications de bureau | kiro-cli settings chat.enableNotifications true |
chat.notificationMethod | string | Méthode de notification : auto, bel ou osc9 | kiro-cli settings chat.notificationMethod "osc9" |
chat.disableMarkdownRendering | boolean | Désactiver le formatage markdown (classique seulement) | kiro-cli settings chat.disableMarkdownRendering false |
chat.disableWrap | boolean | Générer la sortie du chat sans retours à la ligne forcés, pour un copier-coller propre; le retour à la ligne automatique du terminal s'applique toujours. | kiro-cli settings chat.disableWrap true |
chat.disableAutoCompaction | boolean | Désactiver le résumé automatique de la conversation | kiro-cli settings chat.disableAutoCompaction true |
compaction.excludeMessages | number | Nombre minimal de paires de messages à conserver pendant la compaction | kiro-cli settings compaction.excludeMessages 2 |
compaction.excludeContextWindowPercent | number | Pourcentage minimal de la fenêtre de contexte à conserver pendant la compaction | kiro-cli settings compaction.excludeContextWindowPercent 2 |
chat.enablePromptHints | boolean | Afficher des conseils de démarrage avec astuces et raccourcis (v1.26.0+, par défaut : true) | kiro-cli settings chat.enablePromptHints false |
chat.enableHistoryHints | boolean | Afficher les astuces d'historique de conversation (classique seulement) | kiro-cli settings chat.enableHistoryHints true |
chat.uiMode | string | Variante d'interface utilisateur à utiliser | kiro-cli settings chat.uiMode "compact" |
chat.historyMode | string | Portée de l'historique des requêtes : session (par session, par défaut) ou global (partagé entre les sessions). Se configure via /settings history; s'applique à la prochaine session | kiro-cli settings chat.historyMode global |
chat.ui | string | Moteur d'interface utilisateur : tui (par défaut) ou classic | kiro-cli settings chat.ui "classic" |
chat.disableGranularTrust | boolean | Désactiver les options de confiance à paliers pour les approbations d'outils (interface terminal seulement) | kiro-cli settings chat.disableGranularTrust true |
chat.autoExpandToolOutput | boolean | Développer automatiquement la sortie des outils au lieu de la réduire (interface terminal seulement) | kiro-cli settings chat.autoExpandToolOutput true |
chat.modelDefaults | object | Paramètres par défaut par modèle (par exemple, le niveau d'effort) qui s'appliquent aux nouvelles sessions | Voir Effort |
chat.enableContextUsageIndicator | boolean | Afficher le pourcentage d'utilisation du contexte dans la requête (classique seulement) | kiro-cli settings chat.enableContextUsageIndicator true |
Ces paramètres contrôlent la façon dont l'interface terminal affiche la sortie. Les trois s'appliquent immédiatement. Vous pouvez aussi les basculer, ainsi que l'affichage du raisonnement, depuis une session avec /settings display.
| Paramètre | Type | Par défaut | Description | Exemple |
|---|---|---|---|---|
chat.allowAnimations | boolean | true | Indicateurs animés et effets de brillance. Si false, les indicateurs affichent des images statiques | kiro-cli settings chat.allowAnimations false |
chat.allowAsciiArt | boolean | true | Symboles Unicode/braille et dessin de cadres. Si false, revient à l'ASCII simple | kiro-cli settings chat.allowAsciiArt false |
chat.allowIcons | boolean | true | Icônes d'indicateur d'état (●, ○, ⚠). Si false, utilise des étiquettes texte seulement | kiro-cli settings chat.allowIcons false |
chat.showThinking | boolean | true | Afficher les blocs de raisonnement (thinking) de l'agent dans la sortie du chat (v2.5.0+). Démarrage seulement | kiro-cli settings chat.showThinking false |
| Paramètre | Type | Description | Exemple |
|---|---|---|---|
chat.enableKnowledge | boolean | Activer la fonctionnalité de base de connaissances | kiro-cli settings chat.enableKnowledge true |
knowledge.defaultIncludePatterns | array | Motifs de fichiers par défaut à inclure | kiro-cli settings knowledge.defaultIncludePatterns '["*.py", "*.js"]' |
knowledge.defaultExcludePatterns | array | Motifs de fichiers par défaut à exclure | kiro-cli settings knowledge.defaultExcludePatterns '["*.log", "node_modules"]' |
knowledge.maxFiles | number | Nombre maximal de fichiers pour l'indexation | kiro-cli settings knowledge.maxFiles 1000 |
knowledge.chunkSize | number | Taille des blocs de texte pour le traitement | kiro-cli settings knowledge.chunkSize 512 |
knowledge.chunkOverlap | number | Chevauchement entre les blocs de texte | kiro-cli settings knowledge.chunkOverlap 50 |
knowledge.indexType | string | Type d'index de connaissances | kiro-cli settings knowledge.indexType "fast" |
Ces raccourcis clavier s'appliquent uniquement à l'interface classique et n'ont aucun effet dans l'interface terminal.
| Paramètre | Type | Description | Exemple |
|---|---|---|---|
chat.skimCommandKey | char | Touche pour la commande de recherche floue | kiro-cli settings chat.skimCommandKey "f" |
chat.autocompletionKey | char | Touche pour accepter la suggestion d'autocomplétion | kiro-cli settings chat.autocompletionKey "Tab" |
chat.tangentModeKey | char | Touche pour basculer le mode tangente | kiro-cli settings chat.tangentModeKey "t" |
chat.delegateModeKey | char | Touche pour la commande de délégation | kiro-cli settings chat.delegateModeKey "d" |
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é.
| Paramètre | Type | Par défaut | Description | Exemple |
|---|---|---|---|---|
chat.keybindings.cancelStream | string | esc | Annuler la réponse en cours de l'agent pendant sa diffusion | kiro-cli settings chat.keybindings.cancelStream "ctrl+x" |
chat.keybindings.closeMenu | string | esc | Fermer les panneaux superposés et les sélecteurs | kiro-cli settings chat.keybindings.closeMenu "ctrl+[" |
chat.keybindings.quit | string | ctrl+c | Quitter la session de chat | kiro-cli settings chat.keybindings.quit "ctrl+shift+q" |
Configurez la découverte à la demande des outils MCP. Consultez Tool Search pour les détails.
| Paramètre | Type | Description | Exemple |
|---|---|---|---|
toolSearch.enabled | boolean | Activer Tool Search pour la découverte à la demande des outils MCP (par défaut : false) | kiro-cli settings toolSearch.enabled true |
toolSearch.minPct | number | S'active lorsque les specs d'outils MCP dépassent ce % de la fenêtre de contexte (par défaut : 5) | kiro-cli settings toolSearch.minPct 0 |
toolSearch.minTokens | number | S'active lorsque les specs d'outils MCP dépassent ce nombre de jetons (par défaut : 50000) | kiro-cli settings toolSearch.minTokens 0 |
| Paramètre | Type | Description | Exemple |
|---|---|---|---|
chat.enableThinking | boolean | Activer l'outil de raisonnement pour le raisonnement complexe (distinct de chat.showThinking, qui affiche les propres blocs de raisonnement du modèle) | kiro-cli settings chat.enableThinking true |
chat.enableTangentMode | boolean | Activer la fonctionnalité de mode tangente (classique seulement) | kiro-cli settings chat.enableTangentMode true |
introspect.tangentMode | boolean | Entrer automatiquement en mode tangente pour introspect (classique seulement) | kiro-cli settings introspect.tangentMode true |
chat.enableTodoList | boolean | Activer la fonctionnalité de liste de tâches (classique seulement) | kiro-cli settings chat.enableTodoList true |
chat.enableCheckpoint | boolean | Activer la fonctionnalité de point de contrôle (classique seulement) | kiro-cli settings chat.enableCheckpoint true |
chat.enableDelegate | boolean | Activer l'outil de délégation (classique seulement) | kiro-cli settings chat.enableDelegate true |
app.disableAutoupdates | boolean | Désactiver les mises à jour automatiques en arrière-plan | kiro-cli settings app.disableAutoupdates true |
| Paramètre | Type | Description | Exemple |
|---|---|---|---|
api.timeout | number | Délai d'expiration des requêtes API en secondes | kiro-cli settings api.timeout 30 |
| Paramètre | Type | Description | Exemple |
|---|---|---|---|
mcp.initTimeout | number | Délai d'expiration d'initialisation du serveur MCP en millisecondes (par défaut 5000) | kiro-cli settings mcp.initTimeout 10000 |
mcp.noInteractiveTimeout | number | Délai d'expiration d'initialisation MCP en millisecondes pour les exécutions non interactives (par défaut 30000) | kiro-cli settings mcp.noInteractiveTimeout 60000 |
mcp.loadedBefore | boolean | Suivre les serveurs MCP précédemment chargés | kiro-cli settings mcp.loadedBefore true |
# 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"
# Increase API timeout for slow connections kiro-cli settings api.timeout 60 # 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 :
Sauvegardez les paramètres actuels :
kiro-cli settings list --format json > backup.json
Ouvrez le fichier de paramètres :
kiro-cli settings open
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.
| Variable | Description |
|---|---|
KIRO_HOME | Remplace le répertoire ~/.kiro utilisé pour les agents, requêtes, skills, steering, paramètres et sessions globaux. Utile pour conserver plusieurs profils Kiro indépendants sur la même machine. |
KIRO_LOG_NO_COLOR | Définir à 1 pour désactiver la sortie de journal en couleur |
NO_COLOR | Définir à n'importe quelle valeur pour désactiver toute sortie en couleur dans l'interface terminal |
KIRO_ACP_RECORD_PATH | Chemin vers un fichier JSONL pour enregistrer le trafic ACP de l'interface TUI. Utile pour déboguer les problèmes du protocole de communication d'agent. |
KIRO_CLI_TOOL_SEARCH_MATCHING_THRESHOLD | Score de pertinence minimal pour les résultats par mots-clés de Tool Search (par défaut : 1.5) |
Paramètres