Kiro utilise un système de configuration en couches avec trois portées. La configuration la plus proche de votre contexte actuel a priorité sur les paramètres plus généraux.
| Fonctionnalité | IDE | CLI | Web | Mobile |
|---|---|---|---|---|
Portée globale (~/.kiro/) | ✓ | ✓ | — | — |
Portée projet (.kiro/) | ✓ | ✓ | ✓ | ✓ |
Portée agent (.kiro/agents/ ou ~/.kiro/agents/) | ✓ | ✓ | — | — |
~/.kiro/.<project-root>/.kiro/.~/.kiro/agents/ (globale) ou .kiro/agents/ (projet).Dans une session V3 locale ou cloud, exécutez /config pour examiner la configuration utilisée par cette session :
# Open the category summary /config # Open a category directly /config steering
Le sommaire couvre les agents, les serveurs MCP, les Powers, le Steering, les Skills et les Hooks. Il affiche le nombre ou l'état des éléments configurés et vous permet d'ouvrir chaque catégorie. /config n'est pas disponible dans V1 ou V2.
Lorsque Kiro dispose d'informations sur l'origine de la configuration, la colonne Source identifie les éléments comme local, cloud ou local + cloud. Si une session locale ne contient d'informations de source pour aucun élément, Kiro omet la colonne au lieu d'attribuer une origine sans certitude. Dans une session cloud, la configuration de la session est indiquée comme provenant du cloud.
Une étiquette cloud indique la provenance de la configuration active. L'ouverture de /config ne téléverse pas vos fichiers locaux et ne les synchronise pas avec la configuration cloud. Si la configuration cloud n'est pas activée pour votre compte, le panneau reste disponible et affiche la configuration locale sans éléments provenant du cloud.
Utilisez la synchronisation de la configuration dans Kiro Web pour téléverser les dossiers pris en charge depuis votre répertoire .kiro personnel. La configuration téléversée s'applique automatiquement aux sessions cloud.
Pour utiliser la copie infonuagique dans votre travail local, activez Apply your cloud configuration to local sessions sur la page Configuration Sync. Les nouvelles sessions CLI locales chargent alors vos fichiers de Steering, agents personnalisés, Skills, Powers et Hooks infonuagiques. Cette option n'écrit pas le contenu infonuagique dans votre répertoire .kiro local et ne remplace pas les fichiers locaux existants.
Le sommaire des catégories et les listes de Powers, de Steering et de Skills dans le panneau sont en lecture seule. La sélection d'Agents ouvre le sélecteur d'agents existant, dans lequel vous pouvez changer d'agent. Les serveurs MCP et les Hooks ouvrent leurs panneaux existants. /config ne modifie ni ne téléverse les fichiers de configuration, mais certaines vues liées sont interactives.
| Configuration | Portée globale | Portée projet |
|---|---|---|
| Serveurs MCP | ~/.kiro/settings/mcp.json | .kiro/settings/mcp.json |
| Permissions | ~/.kiro/settings/permissions.yaml | ~/.kiro/workspace-roots/<hash>/permissions.yaml (par utilisateur, hors du dépôt) |
| Agents personnalisés | ~/.kiro/agents/ | .kiro/agents/ |
| Steering | ~/.kiro/steering/ | .kiro/steering/ |
| Skills | ~/.kiro/skills/ | .kiro/skills/ |
| Hooks | ~/.kiro/hooks/ | .kiro/hooks/ |
| Powers | ~/.kiro/powers/ | — |
| Specs | — | .kiro/specs/ |
| Paramètres (CLI) | ~/.kiro/settings/cli.json | — |
Toutes les fonctionnalités ne sont pas disponibles à toutes les portées. Le tableau ci-dessous montre où chaque configuration peut être définie et si elle peut être intégrée dans un profil d'agent.
| Configuration | Globale | Projet | Portée agent |
|---|---|---|---|
| Serveurs MCP | ✓ | ✓ | ✓ (champ mcpServers ou includeMcpJson) |
| Permissions | ✓ | ✓ | ✓ (champ permissions) |
| Agents personnalisés | ✓ | ✓ | N/A |
| Steering | ✓ | ✓ | ✓ (champ resources) |
| Skills | ✓ | ✓ | ✓ (champ resources) |
| Hooks | ✓ | ✓ | ✓ (CLI seulement, champ hooks) |
| Powers | ✓ | — | ✓ (champ includePowers) |
| Specs | — | ✓ | — |
| Paramètres | ✓ | — | — |
Lorsque la même configuration existe dans plusieurs portées, la portée la plus proche de votre contexte actuel l'emporte :
| Configuration | Priorité (la plus élevée → la plus faible) |
|---|---|
| Serveurs MCP | Agent > Projet > Global |
| Permissions | le refus l'emporte peu importe la portée (algorithme deny-overrides) |
| Agents personnalisés | Projet > Global (même nom : le projet l'emporte avec un avertissement) |
| Steering | Toutes les portées fusionnées (aucune n'est remplacée) |
| Skills | Toutes les portées fusionnées |
| Hooks | Toutes les portées fusionnées |
Comme les serveurs MCP peuvent être configurés dans trois portées et que les agents ont un paramètre includeMcpJson, la résolution des serveurs MCP comporte des règles supplémentaires. Consultez Priorité de chargement des serveurs MCP pour en savoir plus.
Web et Mobile lisent la configuration de projet commise dans le dépôt, mais leur couverture diffère : Mobile lit le Steering et les Skills de projet, tandis que Kiro Web lit également les serveurs MCP, les agents personnalisés et les Hooks de projet (consultez le tableau ci-dessous). Aucune de ces surfaces ne lit la configuration globale ~/.kiro/, puisqu'elles n'ont pas de système de fichiers local. Kiro Web peut aussi utiliser certaines configurations personnelles que vous téléversez au moyen de la synchronisation de la configuration.
| Configuration | Web | Mobile |
|---|---|---|
Steering de projet (.kiro/steering/) | ✓ | ✓ |
Skills de projet (.kiro/skills/) | ✓ | ✓ |
Serveurs MCP de projet (.kiro/settings/mcp.json) | ✓ | — |
Agents personnalisés de projet (.kiro/agents/, délégation aux sous-agents) | ✓ | — |
Hooks de projet (.kiro/hooks/) | ✓ | — |
| MCP en bac à sable (configuré via les paramètres Web) | ✓ | — |
| Autorisations YAML et approbations interactives | — | — |
Pour les sessions cloud, ouvrez Settings > Sync dans Kiro Web afin de téléverser votre Steering personnel, vos agents personnalisés, vos Skills et vos Hooks. Gérez les éléments téléversés depuis les pages de paramètres propres à chaque fonctionnalité. Cette configuration infonuagique gérée est distincte du répertoire ~/.kiro/ de votre ordinateur et ne modifie pas vos fichiers locaux.
Consultez Agents personnalisés : comportement selon la surface pour en savoir plus sur les limitations de Web et Mobile.
Portées de configuration