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.
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.
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.
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.
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.
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.
Migrez votre configuration
Parcourez le guide de migration, puis les guides sur les permissions, les Hooks et les clients ACP qui s'appliquent à vous.
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.
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 →
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 V3 | Ce qui est disponible maintenant | Détails |
|---|---|---|---|
| Clavardage et interface du terminal | Disponible | Rendu Markdown, fiches d'outils, option Preserve scrollback, progression en direct et clavardage plein écran | Interface utilisateur du terminal |
| Saisie des requêtes | Disponible | Références de fichiers, chemins d'images et images du presse-papiers, messages en file d'attente et modification sur plusieurs lignes | Utilisation des images, Références de fichiers |
| Paramètres et affichage | Disponible | Paramè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 terminal | Paramètres en session, Référence des paramètres |
| Modèles et raisonnement | Disponible | Sélection du modèle de session ainsi que les contrôles Thinking et Effort dans /model, avec des valeurs par défaut enregistrées explicitement | Modèles, Effort de raisonnement |
| Aide sur la documentation | Disponible | Un sous-agent Introspect répond aux questions sur les fonctionnalités de Kiro à partir de la documentation officielle | Agents intégrés |
| Workflows | Disponible; sur activation | Exécutions en plusieurs étapes en arrière-plan après avoir défini chat.enableWorkflows | Workflows |
| Specs et mode Plan | Disponible | Cré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 écran | Specs |
| Tangent et rewind | Disponible; V3 étend Tangent | Rewind crée une ramification à partir d'un tour précédent; V3 ajoute des conversations parallèles nommées qui peuvent s'imbriquer | Tangent, Rewind |
| Agents personnalisés | Disponible; migration requise | Profils d'agent universels, création assistée par l'IA, modification et /upgrade-agent | Agents personnalisés, Mise à niveau des configurations d'agent |
| Permissions | Disponible; migration requise | Règles de capacités, politiques persistantes à portée définie, approbations granulaires et confiance à l'échelle de la session | Permissions |
| Hooks | Disponible; migration requise | Hooks de projet autonomes, Hooks globaux, déclencheurs bloquants et confirmation dynamique | Hooks |
| Serveurs MCP | Disponible | Rechargement à chaud de la configuration, contrôles d'authentification, clients OAuth préenregistrés et prise en charge de la version actuelle du protocole | Configuration MCP |
| Sous-agents | Disponible | Travail parallèle isolé, aperçus des requêtes, moniteur Ctrl+G et délais d'inactivité | Sous-agents, Interface utilisateur du terminal |
| Sessions locales | Disponible | Reprise, exportation, recherche et nettoyage dans le tableau de bord, indexation des réponses et relecture complète des résultats d'outils enregistrés | Gestion des sessions |
| Automatisation sans interface | Disponible | Sortie 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 requis | Mode sans interface |
| Sessions cloud | V3 seulement | Sessions 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 bord | Sessions cloud |
| Saisie vocale | Disponible | Saisie locale par reconnaissance de la parole avec /voice | Mode vocal |
| Configuration et Steering | Disponible | Fichiers AGENTS.md imbriqués, panneau /config et Configuration Sync facultative pour les nouvelles sessions locales | Configuration, Steering |
| Skills et Powers | Disponible | Découverte des Skills, Powers installés depuis l'IDE et liste /powers | Skills, Powers |
| Intelligence du code et connaissance | Disponible | Navigation dans le code appuyée par LSP et index de connaissances sémantiques | Intelligence du code, Bases de connaissances |
| Changement | Avant (2.x) | Maintenant (V3) | Impact |
|---|---|---|---|
| Outil AWS intégré non disponible | Outil 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 V2 | Magasin 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 profil | Définitions sous forme de tableau en PascalCase, en ligne ou dans des fichiers autonomes .kiro/hooks/*.json | Élevé |
| Noms des déclencheurs de Hooks | camelCase (agentSpawn) | PascalCase (SessionStart) | Élevé |
| Configuration de confiance persistante modifiée | Règles toolsSettings par outil | permissions.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 parente | Les outils approuvés au préalable d'un sous-agent s'exécutaient sans invite, même si le parent ne les autorisait pas | L'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 TUI | Le 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ées | Application de bureau avec complétion automatique et suggestions en ligne dans le shell | Dans 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ées | kiro-cli autocomplete, inline, translate, theme, dashboard et doctor | autocomplete, 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 issue | Moyen. Consultez kiro-cli diagnostic et kiro-cli issue |
| Concept « Vibe » supprimé | Sans objet pour CLI | Le mode « Default » est le nom standard | Faible |
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.
- Guide de migration complet : les 7 étapes complètes, avec exemples
- Mise à niveau des configurations d'agent : ce que
/upgrade-agentconvertit, ses diagnostics et la mise à niveau automatique au démarrage de V3 (désactivée lorsquechat.enableAutoAgentUpgradeestfalse) - Migration des permissions : configuration de confiance de CLI 2.x →
permissions.yaml, changements de comportement - Migration des Hooks : anciens Hooks en forme d'objet → tableaux à la portée du profil ou fichiers autonomes
.kiro/hooks/, correspondance des noms de déclencheurs - Migration des clients ACP : mettre à jour les clients ACP du serveur CLI v2 vers CLI V3
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.
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.
V3 ne reproduit pas toutes les anciennes surfaces. Ces différences demeurent pertinentes au moment de décider si vous passez à V3 :
| Différence | Comportement de V3 | Si vous dépendez du comportement de V2 |
|---|---|---|
| Interface classique | Le 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 harnais | Déplacez le flux de travail vers l'interface utilisateur du terminal; consultez Interface utilisateur du terminal |
| Points de contrôle de l'espace de travail | La fonctionnalité expérimentale /checkpoint n'est pas disponible sur V3; V3 offre /rewind pour les ramifications de conversation | Utilisez 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.
- Choisir un harnais d'agent : valeurs par défaut, choix pour une exécution et choix enregistrés, vérification et moyen de revenir à V2
- Dépannage : diriger un symptôme vers la page qui détient le correctif
- Référence de CLI 2.x : comment les Hooks, la confiance et le compactage de 2.x se comportaient
- Documentation des Hooks : référence complète des Hooks
- Configuration MCP : configuration des serveurs MCP
- Steering : détails sur les documents Steering
Mettre à niveau depuis CLI 2.x