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/ |
| Workflows | ~/.kiro/workflows/ | .kiro/workflows/ |
| 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 | — | ✓ | — |
| Workflows | ✓ | ✓ | — |
| 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 |
| Workflows | Projet > Global > recettes de compte synchronisées > recettes intégrées |
Une recette de workflow non valide de priorité supérieure ne masque pas une recette valide de priorité inférieure portant le même nom. Les recettes synchronisées et intégrées disponibles peuvent varier selon le compte et la version du client.
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 indiquée ci-dessous à partir de dépôts clonés, 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. Aucune de ces surfaces ne lit la configuration globale ~/.kiro/, puisqu'elles n'ont pas de système de fichiers local.
| 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 | — | — |
Dans Kiro Web, les workflows utilisent un chemin de téléversement dans le compte distinct :
| Méthode | Web | Mobile |
|---|---|---|
| Téléverser une recette par Settings > Workflows | ✓ | Non documenté |
Importer .kiro/workflows/ au moyen de Configuration Sync | ✓ | Non documenté |
Pour les sessions cloud, ouvrez Settings > Sync dans Kiro Web afin de téléverser votre Steering personnel, vos agents personnalisés, vos Skills, vos Hooks ou un dossier .kiro/workflows/ complet. 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