Synchronisation de la configuration

Kiro IDE et Kiro CLI lisent votre configuration personnelle depuis le répertoire local ~/.kiro. Les sessions cloud s'exécutent dans un bac à sable géré qui ne peut pas accéder à votre ordinateur; ce répertoire ne s'y applique donc pas automatiquement. La synchronisation de la configuration comble cet écart : téléversez les dossiers pris en charge depuis votre répertoire .kiro local vers Kiro Web, et l'agent utilise la copie infonuagique dans chaque session cloud. Vous pouvez aussi appliquer la copie infonuagique aux nouvelles sessions locales de l'IDE et de la CLI.

Ouvrez les paramètres de Kiro Web et sélectionnez Sync sous Configuration dans la barre latérale pour commencer.

Téléversez un dossier de premier niveau depuis votre répertoire .kiro local à la fois. Six dossiers sont pris en charge :

Tout autre élément à la racine de .kiro, comme l'état des sessions, les caches et les dossiers d'exécution, est refusé. Dans les dossiers pris en charge, Kiro filtre le contenu généré par la machine, notamment .git, node_modules et .DS_Store.

1. Dans Kiro Web, accédez à Settings > Sync.
2. Glissez un dossier pris en charge, comme ~/.kiro/steering, dans la zone de téléversement, ou sélectionnez-le avec le sélecteur de dossiers.
3. Examinez chaque fichier et son état. Développez une ligne pour inspecter son contenu.
4. Sélectionnez les fichiers à synchroniser, puis choisissez Upload N files. La progression est indiquée pour chaque fichier, et vous pouvez réessayer les fichiers qui ont échoué.

Chaque état décrit l'effet du téléversement :

• Les fichiers New n'existent pas dans le nuage et sont sélectionnés par défaut.
• Les fichiers Update existent dans le nuage avec un contenu différent. Les mises à jour sont facultatives et désélectionnées par défaut, car le téléversement remplace la copie infonuagique. Les fichiers de Steering et les serveurs MCP affichent une comparaison côte à côte.
• Les fichiers Synced correspondent déjà à la copie infonuagique et ne sont pas téléversés.
• Les fichiers Unsupported appartiennent à une catégorie sans stockage infonuagique, comme un fichier binaire dans un Skill.
• Les fichiers Too large dépassent la limite de taille par élément et doivent être réduits avant leur synchronisation.
• Les fichiers Error ne peuvent pas être associés à une action sûre, par exemple lorsque deux fichiers locaux ciblent le même document infonuagique. Corrigez-les localement, puis téléversez-les de nouveau.

Les Powers suivent l'un de deux parcours :

• Powers du catalogue : Si le nom du Power correspond exactement à un Power du catalogue, Kiro l'installe par son nom, et le service fournit l'ensemble de fichiers révisé. Seul POWER.md permet une action dans la révision du téléversement.
• Powers personnalisés : Les Powers qui ne figurent pas dans le catalogue sont téléversés comme fichiers texte individuels. Les noms qui diffèrent de ceux des Powers du catalogue ou gérés par Amazon uniquement par la casse sont refusés. Renommez le dossier pour l'utiliser comme Power personnalisé.

La configuration infonuagique s'applique toujours aux sessions cloud. Vous pouvez aussi l'utiliser dans vos sessions locales.

Sur la page Configuration Sync, activez Apply your cloud configuration to local sessions. Au démarrage d'une nouvelle session locale de l'IDE ou de la CLI, Kiro charge 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.

• Téléversez un dossier de premier niveau pris en charge à la fois.
• Chaque élément téléversé peut atteindre 4 000 000 d'octets.
• Un Skill peut contenir jusqu'à 25 fichiers.
• Un Power personnalisé peut contenir jusqu'à 50 fichiers.
• Les Skills et les Powers personnalisés prennent uniquement en charge les fichiers texte.
• La sélection d'un élément Update remplace la copie infonuagique; les téléversements ne fusionnent pas le contenu des fichiers.

La configuration téléversée apparaît sur la page de paramètres propre à sa fonctionnalité. Vous pouvez y consulter, modifier, télécharger ou supprimer les éléments pris en charge. Elle s'applique ensuite automatiquement aux sessions cloud avec la configuration de projet clonée avec le dépôt.

Le téléversement se fait du système local vers le nuage. Les modifications apportées dans les paramètres de Kiro Web ne sont pas réécrites sur votre ordinateur. Considérez votre répertoire .kiro local comme la source de vérité lorsque vous souhaitez conserver la même configuration sur le disque, puis téléversez-la de nouveau lorsqu'elle change.

• Sessions cloud - endroit où la configuration téléversée prend effet
• Portées de configuration - fonctionnement conjoint de la configuration personnelle, de projet et infonuagique
• Steering - rédaction de fichiers de Steering
• Agents personnalisés - création d'agents spécialisés
• Skills - création de modules d'instructions réutilisables
• Hooks - automatisation des événements d'agent
• Powers et MCP - extension du bac à sable infonuagique