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).| 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.
Les clients Web et Mobile ne lisent que la configuration de portée projet commise au dépôt. La configuration globale (~/.kiro/) n'est pas disponible — il n'y a pas de système de fichiers local sur ces surfaces.
| Configuration | Web | Mobile |
|---|---|---|
Steering de projet (.kiro/steering/) | ✓ | ✓ |
Skills de projet (.kiro/skills/) | ✓ | ✓ |
Serveurs MCP de projet (.kiro/settings/mcp.json) | — | — |
| MCP en bac à sable (configuré via les paramètres Web) | ✓ | — |
| Permissions | — | — |
| Hooks | — | — |
Consultez Agents personnalisés : comportement selon la surface pour en savoir plus sur les limitations Web/Mobile.
Portées de configuration