Passer au contenu principal
Afficher en Markdown

Mettre à niveau depuis CLI 2.x

Dans Kiro CLI 3.0.0 ou une version ultérieure, V3 est l'expérience normale de la CLI. Cette page s'adresse à quiconque exécute encore des sessions, des configurations d'agent, des permissions, des Hooks ou des clients ACP de Kiro CLI 2.x. Suivez les étapes dans l'ordre; chacune se termine par une vérification, et V2 reste à une commande de distance jusqu'à ce que vous ayez terminé. Pour la documentation quotidienne de la CLI, commencez à CLI.

Un harnais unique pour toutes les surfaces Kiro

CLI V3 utilise le même harnais d'agent unifié que Kiro IDE et Kiro Web. Cela apporte au terminal les améliorations partagées de la boucle d'agent et permet à la configuration .kiro prise en charge de passer d'une surface à l'autre. Certains outils, commandes et champs de configuration demeurent propres à une surface; les tableaux ci-dessous indiquent le chemin V3 pris en charge. Pour savoir comment la CLI choisit entre le harnais V3 et le harnais V2, consultez Choisir un harnais d'agent.

Votre parcours de mise à niveau

1

Vérifiez votre version

Exécutez kiro-cli --version et confirmez qu'il indique 3.0.0 ou une version ultérieure. Sinon, mettez d'abord à jour; consultez Installation.

2

Choisissez le harnais

Lisez Choisir un harnais d'agent pour savoir quel harnais chaque type de lancement démarre et comment un script, un pipeline ou un client ACP doit en nommer un. Gardez kiro-cli --v2 disponible jusqu'à ce que vos vérifications V3 réussissent.

3

Démarrez V3

Exécutez kiro-cli sans indicateur de harnais et répondez à l'invite du premier lancement décrite sous Répondre à l'invite du premier lancement, ou exécutez kiro-cli --v3, qui saute l'invite et n'enregistre aucune valeur par défaut. Lorsque V3 démarre, il met à niveau automatiquement vos configurations d'agent V2, sauf si chat.enableAutoAgentUpgrade est false; consultez Mise à niveau des configurations d'agent.

4

Préservez vos sessions

V3 conserve un magasin de sessions distinct. Reprenez une session V2 dans V3 avec --resume ou --resume-id, ce qui crée une copie V3 et conserve l'original. Consultez Démarrer V3 et garder les sessions V2 accessibles.

5

Migrez votre configuration

Parcourez le guide de migration, puis les guides sur les permissions, les Hooks et les clients ACP qui s'appliquent à vous.

6

Vérifiez, et gardez un moyen de revenir

Une session V3 s'ouvre avec Welcome to Kiro CLI V3. Si quelque chose dont vous dépendez manque, revenez à V2 pour une exécution avec kiro-cli --v2 ou enregistrez-le avec kiro-cli settings chat.agentEngine v2; consultez Revenir à V2.

Nouveautés de V3

Développement piloté par Spec : l'agent Spec apporte un développement structuré au terminal. Définissez des exigences, générez des conceptions, exécutez des plans de tâches. Utilisez /spec new <name> pour commencer. En savoir plus →

Permissions basées sur les capacités : déclarez des politiques structurées dans permissions.yaml pour un contrôle granulaire et vérifiable. Une seule règle peut autoriser ou refuser une catégorie entière d'opérations dans tous les outils. En savoir plus →

Hooks améliorés : des fichiers autonomes .kiro/hooks/*.json avec deux types d'action (commandes shell et requêtes d'agent), de nouveaux déclencheurs et un schéma versionné. En savoir plus →

Configuration d'agent améliorée : sélection d'outils basée sur des balises, bloc de permissions unifié, format Markdown, serveurs MCP déclarés en ligne. En savoir plus →

Sous-agent Introspect : posez des questions à Kiro sur ses propres fonctionnalités et il répond à partir de la documentation officielle. En savoir plus →

Workflows : exécutez des travaux en plusieurs étapes en arrière-plan pendant que la conversation principale reste disponible. Activez-les avec le paramètre chat.enableWorkflows et redémarrez Kiro CLI. En savoir plus →

Tangent : ramifiez votre conversation en conversations parallèles qui héritent de votre contexte, explorez librement, puis revenez exactement où vous étiez. Utilisez /tangent pour créer une ramification. En savoir plus →

Parité des fonctionnalités aujourd'hui

Le tableau suit la prise en charge actuelle de V3 pour les flux de travail de base de la CLI et les capacités qui n'existent que sur le harnais partagé. « Disponible » signifie que la tâche du lecteur dispose d'un chemin V3 pris en charge; l'interface ou le format de configuration peut tout de même différer de V2.

DomaineÉtat V3Ce qui est disponible maintenantDétails
Clavardage et interface du terminalDisponibleRendu Markdown, fiches d'outils, option Preserve scrollback, progression en direct et clavardage plein écranInterface utilisateur du terminal
Saisie des requêtesDisponibleRéférences de fichiers, chemins d'images et images du presse-papiers, messages en file d'attente et modification sur plusieurs lignesUtilisation des images, Références de fichiers
Paramètres et affichageDisponibleParamètres globaux et d'espace de travail, mode ASCII, indicateurs d'activité personnalisés, historique partagé ou par session, et contrôle de l'historique du terminalParamètres en session, Référence des paramètres
Modèles et raisonnementDisponibleSélection du modèle de session ainsi que les contrôles Thinking et Effort dans /model, avec des valeurs par défaut enregistrées explicitementModèles, Effort de raisonnement
Aide sur la documentationDisponibleUn sous-agent Introspect répond aux questions sur les fonctionnalités de Kiro à partir de la documentation officielleAgents intégrés
WorkflowsDisponible; sur activationExécutions en plusieurs étapes en arrière-plan après avoir défini chat.enableWorkflowsWorkflows
Specs et mode PlanDisponibleCréation guidée de Specs, passage automatique au mode Plan, révision des Specs dans le terminal et exécution des tâches en plein écranSpecs
Tangent et rewindDisponible; V3 étend TangentRewind crée une ramification à partir d'un tour précédent; V3 ajoute des conversations parallèles nommées qui peuvent s'imbriquerTangent, Rewind
Agents personnalisésDisponible; migration requiseProfils d'agent universels, création assistée par l'IA, modification et /upgrade-agentAgents personnalisés, Mise à niveau des configurations d'agent
PermissionsDisponible; migration requiseRègles de capacités, politiques persistantes à portée définie, approbations granulaires et confiance à l'échelle de la sessionPermissions
HooksDisponible; migration requiseHooks de projet autonomes, Hooks globaux, déclencheurs bloquants et confirmation dynamiqueHooks
Serveurs MCPDisponibleRechargement à chaud de la configuration, contrôles d'authentification, clients OAuth préenregistrés et prise en charge de la version actuelle du protocoleConfiguration MCP
Sous-agentsDisponibleTravail parallèle isolé, aperçus des requêtes, moniteur Ctrl+G et délais d'inactivitéSous-agents, Interface utilisateur du terminal
Sessions localesDisponibleReprise, exportation, recherche et nettoyage dans le tableau de bord, indexation des réponses et relecture complète des résultats d'outils enregistrésGestion des sessions
Automatisation sans interfaceDisponibleSortie d'événements JSON Lines, valeurs par défaut enregistrées pour l'agent et le modèle, enregistrements d'interruption et vérifications au démarrage des serveurs MCP requisMode sans interface
Sessions cloudV3 seulementSessions gérées en bac à sable qui continuent de s'exécuter après la déconnexion, avec les sessions locales et cloud dans un même tableau de bordSessions cloud
Saisie vocaleDisponibleSaisie locale par reconnaissance de la parole avec /voiceMode vocal
Configuration et SteeringDisponibleFichiers AGENTS.md imbriqués, panneau /config et Configuration Sync facultative pour les nouvelles sessions localesConfiguration, Steering
Skills et PowersDisponibleDécouverte des Skills, Powers installés depuis l'IDE et liste /powersSkills, Powers
Intelligence du code et connaissanceDisponibleNavigation dans le code appuyée par LSP et index de connaissances sémantiquesIntelligence du code, Bases de connaissances

Changements majeurs

ChangementAvant (2.x)Maintenant (V3)Impact
Outil AWS intégré non disponibleOutil use_aws de CLI 2.x (alias privilégié aws)Utilisez des serveurs MCP pour l'accès AWSÉlevé
Format de session modifiéMagasin de sessions V2Magasin de sessions V3 distinctÉlevé. V3 importe une session V2 sous forme de copie V3; V2 ne peut pas ouvrir une session V3
Format des Hooks modifiéObjet en CamelCase intégré au profilDéfinitions sous forme de tableau en PascalCase, en ligne ou dans des fichiers autonomes .kiro/hooks/*.jsonÉlevé
Noms des déclencheurs de HookscamelCase (agentSpawn)PascalCase (SessionStart)Élevé
Configuration de confiance persistante modifiéeRègles toolsSettings par outilpermissions.yaml basé sur les capacités; la confiance à l'échelle de la session utilise --trust-all-tools ou /tools trust-allÉlevé
Appels d'outils des sous-agents vérifiés par rapport à la session parenteLes outils approuvés au préalable d'un sous-agent s'exécutaient sans invite, même si le parent ne les autorisait pasL'appel d'outil d'un sous-agent s'exécute sans invite seulement lorsque la politique de la session parente l'autorise aussiÉlevé. Les exécutions sans interface refusent l'appel. Consultez Autorisations des sous-agents
Interface classique retirée--classic ou --legacy-ui ouvrait l'interface autre que la TUILe clavardage interactif s'exécute dans l'interface utilisateur du terminal sur V3 ou V2; un lancement qui sélectionne encore l'interface classique se voit proposer V3Élevé. Consultez Si un lancement sélectionne encore l'interface classique
Application de bureau et complétion automatique en ligne retiréesApplication de bureau avec complétion automatique et suggestions en ligne dans le shellDans Kiro CLI 3.0.0 ou une version ultérieure, un seul binaire autonome kiro-cli; les installations existantes de l'application de bureau macOS basculent vers celui-ci lors de leur prochaine vérification de mise à jourÉlevé. Consultez Migrer depuis l'application de bureau Kiro CLI
Commandes de l'application de bureau retiréeskiro-cli autocomplete, inline, translate, theme, dashboard et doctorautocomplete, inline, translate, theme et dashboard ne sont pas disponibles. L'exécution de kiro-cli doctor vous dirige vers kiro-cli diagnostic ou kiro-cli issueMoyen. Consultez kiro-cli diagnostic et kiro-cli issue
Concept « Vibe » suppriméSans objet pour CLILe mode « Default » est le nom standardFaible

Guide de migration

Démarrez V3 et exécutez /upgrade-agent pour convertir les champs d'agent pris en charge, les permissions et les Hooks en forme d'objet. Examinez ensuite ses diagnostics et n'apportez que les changements manuels qu'il signale ou que votre flux de travail exige. Exécutez-le de nouveau après avoir modifié les paramètres de confiance V2 pour que les règles V3 générées restent à jour.

Le format actuel de configuration d'agent, y compris la forme Markdown, est documenté dans la référence de configuration d'agent. Les capacités que V3 ajoute sont documentées sur leurs propres pages, énumérées sous Parité des fonctionnalités aujourd'hui.

Changer à partir de l'offre au démarrage

Dans Kiro CLI 3.0.0 ou une version ultérieure, le premier lancement interactif demande aux utilisateurs existants de Kiro CLI 2.x ayant des sessions enregistrées de choisir un harnais avant que V3 s'applique. Les réponses, ce que chacune enregistre et les cas où l'invite est sautée sont décrits sous Répondre à l'invite du premier lancement.

Différences restantes par rapport à V2

V3 ne reproduit pas toutes les anciennes surfaces. Ces différences demeurent pertinentes au moment de décider si vous passez à V3 :

DifférenceComportement de V3Si vous dépendez du comportement de V2
Interface classiqueLe harnais V3 s'exécute dans l'interface du terminal. L'interface classique ne s'exécute plus pour le clavardage interactif sur l'un ou l'autre des harnaisDéplacez le flux de travail vers l'interface utilisateur du terminal; consultez Interface utilisateur du terminal
Points de contrôle de l'espace de travailLa fonctionnalité expérimentale /checkpoint n'est pas disponible sur V3; V3 offre /rewind pour les ramifications de conversationUtilisez la gestion de versions pour restaurer les fichiers et /rewind pour revenir à un tour précédent

V3 peut reprendre ses propres sessions et vos sessions V2, mais V2 ne peut pas ouvrir une session V3 parce que les formats de session stockés diffèrent. Consultez Démarrer V3 et garder les sessions V2 accessibles pour connaître les commandes de reprise et ce qui arrive à la session V2 originale et à ses approbations d'outils enregistrées.

En savoir plus

Page mise à jour : 3 novembre 2026