Utiliser Kiro CLI : le guide pas à pas

Pour utiliser Kiro CLI, installez-le avec curl -fsSL https://cli.kiro.dev/install | bash (ou brew install kiro-cli sur macOS), connectez-vous dans le navigateur, lancez kiro-cli dans le dossier d’un projet et décrivez ce que vous voulez. Kiro lit votre code, modifie des fichiers et exécute des commandes, en vous demandant votre accord avant d’utiliser un outil auquel vous ne faites pas encore confiance. Tapez /model pour choisir un modèle, ou laissez Auto et Kiro décide.

Voilà la boucle de base. Ce guide couvre le reste : la connexion, les commandes de chat du quotidien, les modèles et les crédits, les fichiers de steering, les agents personnalisés, les serveurs MCP, les specs, Kiro en CI et Kiro aux côtés d’autres agents. Tout suit la documentation officielle de Kiro en date d’octobre 2026.

Ce qu’est Kiro

Kiro est l’environnement de développement agentique d’AWS. Il existe sous plusieurs formes qui partagent un même compte : un IDE de bureau, la CLI et Kiro Web. La CLI en est la partie terminal. Elle propose un chat interactif avec une interface plein écran dans le terminal, un mode headless pour les scripts et la CI, et peut servir d’agent aux éditeurs qui parlent l’Agent Client Protocol (ACP).

Ce qui distingue Kiro des autres agents de code, c’est l’accent mis sur les specs. Avant d’écrire le code d’une fonctionnalité, Kiro peut transformer votre idée en exigences, en design et en liste de tâches, puis traiter les tâches une à une. Si l’approche est nouvelle pour vous, Développement piloté par les specs avec des agents IA explique l’idée et compare Kiro aux autres outils qui le font.

Un mot sur les versions : l’installeur fournit Kiro CLI 2.x. La version 3 est une version précoce que vous pouvez essayer avec kiro-cli --v3. Elle tourne à côté de votre installation 2.x, et votre configuration reste telle quelle tant que vous ne basculez pas. Ce guide suit la 2.x et signale les différences avec la V3.

Étape 1 : installer Kiro CLI

Sous Linux, il existe aussi un paquet .deb, un AppImage et une archive zip. La CLI demande glibc 2.34 ou plus récent ; sur une distribution plus ancienne, prenez la variante musl du zip. Sous Windows, lancez l’installeur dans PowerShell ou Windows Terminal ; l’ancienne invite de commandes n’est pas prise en charge.

Vérifiez que tout fonctionne :

kiro-cli doctor

kiro-cli update cherche une nouvelle version et kiro-cli settings app.disableAutoupdates true désactive les mises à jour automatiques. Avec Homebrew, mettez à jour via brew upgrade --greedy kiro-cli.

Étape 2 : se connecter

Après l’installation, Kiro ouvre le navigateur pour la connexion. Les options sont :

• GitHub ou Google : le plus rapide pour un usage individuel.
• AWS Builder ID : une identité AWS personnelle et gratuite.
• AWS IAM Identity Center : pour les entreprises qui gèrent Kiro via AWS. Vous saisissez l’URL de démarrage et la région de votre organisation.
• Un fournisseur d’identité externe : comme Okta ou Microsoft Entra ID, si votre entreprise l’a configuré.

kiro-cli login permet de se reconnecter à tout moment. Sur une machine distante sans navigateur, kiro-cli login --use-device-flow affiche une URL et un code à ouvrir sur un autre appareil. Le device flow fonctionne avec Builder ID, IAM Identity Center, Google et GitHub, mais pas avec un fournisseur d’identité externe. kiro-cli whoami indique le compte connecté et kiro-cli logout vous déconnecte.

Bon à savoir : avec l’offre gratuite et les offres individuelles, Kiro peut utiliser votre contenu pour améliorer le service. Vous pouvez le refuser ; la documentation de Kiro explique comment.

Étape 3 : les bases du chat

Placez-vous dans un projet et lancez Kiro :

cd my-project
kiro-cli

L’interface terminal est celle par défaut. Quelques gestes reviennent sans cesse :

• @chemin joint un fichier à votre message.
• ! en début de ligne exécute directement une commande shell, par exemple !npm test.
• Shift+Tab passe en mode plan, où Kiro réfléchit à un changement avant de toucher au code.
• Shift+Enter ou Ctrl+J ajoute une nouvelle ligne, Ctrl+O déplie les sorties longues, Ctrl+C quitte.
• /paste colle une image depuis le presse-papiers.

Les chats sont enregistrés par dossier. kiro-cli chat --resume reprend le dernier chat du dossier courant, --resume-picker vous laisse en choisir un et --list-sessions les liste. Si vous préférez l’ancienne interface ligne par ligne, lancez kiro-cli chat --classic.

Étape 4 : modèles et crédits

Par défaut, Kiro utilise Auto, qui envoie chaque requête vers un modèle adapté. La documentation le recommande pour la plupart des tâches. Pour choisir vous-même, tapez /model dans le chat ou listez les modèles depuis le shell :

kiro-cli chat --list-models

Pour faire d’un modèle celui par défaut, réglez-le :

kiro-cli settings chat.defaultModel "claude-sonnet-4.6"

Kiro facture en crédits, et chaque modèle a un multiplicateur. En octobre 2026, Claude Opus 5 compte 2,2 fois, Claude Sonnet 5.5 1,3 fois, DeepSeek 3.2 0,25 fois et Qwen3 Coder Next 0,05 fois. Une même tâche peut donc coûter très différemment selon le modèle : jetez un œil à /usage de temps en temps.

Les offres payantes peuvent continuer au-delà de leurs crédits à 0,04 $ par crédit, et des packs supplémentaires existent. L’offre gratuite couvre les modèles open-weight et Claude Sonnet 4.5 ; les modèles Claude les plus récents demandent une offre payante. Les prix et les modèles changent souvent, vérifiez kiro.dev/pricing avant de choisir.

Étape 5 : fichiers de steering et AGENTS.md

Les fichiers de steering sont des fichiers Markdown qui contiennent les règles de votre projet : ce que fait le produit, la stack technique, où se trouve quoi, ce qu’il faut éviter. Kiro les cherche à deux endroits :

• Workspace : .kiro/steering/ dans le projet, versionné avec le code.
• Global : ~/.kiro/steering/, pour les règles valables partout. En cas de conflit, le workspace l’emporte.

La documentation conseille de commencer par trois fichiers : product.md, tech.md et structure.md. Par défaut, un fichier de steering est inclus dans chaque chat. Vous pouvez le limiter à certains fichiers avec un front matter :

---
inclusion: fileMatch
fileMatchPattern: "components/**/*.tsx"
---

- Les composants sont des composants fonctionnels avec des exports nommés.
- Les styles utilisent des CSS modules ; pas de styles inline.

Il existe quatre modes : always (par défaut), fileMatch, manual (vous l’ajoutez avec #nom-du-fichier) et auto (Kiro décide selon le nom et la description du fichier). Kiro CLI 2.x ne charge automatiquement que les fichiers always ; la V3 prend en charge les quatre.

Kiro lit aussi AGENTS.md et le traite comme un fichier de steering toujours inclus. Si votre équipe en maintient déjà un pour Codex, opencode ou d’autres agents, Kiro l’utilise tel quel. Pour savoir quoi y mettre, voyez Bonnes pratiques CLAUDE.md.

Étape 6 : agents personnalisés

Un agent personnalisé est une configuration enregistrée, avec son prompt, son modèle, ses outils et ses fichiers de contexte. Créez-en un avec :

kiro-cli agent create my-agent

Les agents se trouvent dans .kiro/agents/ (par projet) ou ~/.kiro/agents/ (globaux), en JSON ou, avec la V3, aussi en Markdown. Un court exemple :

{
  "name": "my-agent",
  "description": "Reviews backend changes",
  "prompt": "You are a careful backend reviewer.",
  "model": "claude-sonnet-4.6",
  "includeMcpJson": true,
  "resources": ["file://.kiro/steering/**/*.md", "file://./ARCHITECTURE.md"]
}

Ouvrez un chat avec lui via kiro-cli --agent my-agent, changez d’agent dans le chat avec /agent, ou faites-en l’agent par défaut avec kiro-cli settings chat.defaultAgent my-agent. kiro-cli agent list affiche vos agents et kiro-cli agent validate vérifie un fichier.

Deux pièges. D’abord, les agents personnalisés n’incluent pas d’eux-mêmes les fichiers de steering ; c’est pourquoi l’exemple ajoute .kiro/steering/**/*.md dans resources. Ensuite, les agents du dossier d’un projet ne se chargent qu’une fois ce workspace approuvé. Les champs de permissions des outils diffèrent entre 2.x et V3 ; /upgrade-agent convertit un agent quand vous passez à la V3.

Étape 7 : serveurs MCP

Les serveurs MCP donnent de nouveaux outils à Kiro : recherche dans la documentation, un navigateur, votre gestionnaire de tickets. Ils se déclarent dans un fichier mcp.json, soit .kiro/settings/mcp.json dans le projet, soit ~/.kiro/settings/mcp.json pour tous les projets :

{
  "mcpServers": {
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"],
      "disabled": false
    },
    "my-remote": {
      "url": "https://mcp.example.com/mcp"
    }
  }
}

Un serveur local est une commande que Kiro lance ; un serveur distant est une URL (HTTPS, ou HTTP sur localhost), avec des headers optionnels et une connexion OAuth. Dans le shell, kiro-cli mcp add ajoute un serveur, kiro-cli mcp list affiche la configuration et kiro-cli mcp status indique si chaque serveur tourne. Dans le chat, /mcp fait la même chose et gère les serveurs qui demandent une connexion.

Si le même serveur est défini à plusieurs endroits, le réglage d’un agent prime sur le fichier du workspace, qui prime sur le fichier global. Chaque serveur ajoute des outils au contexte : désactivez ceux dont vous n’avez pas besoin avec "disabled": true.

Étape 8 : les specs

Les specs sont la signature de Kiro. Pour tout ce qui dépasse un correctif rapide, créez-en une :

/spec new user-invitations

Kiro écrit trois fichiers dans .kiro/specs/user-invitations/ : requirements.md avec des user stories et des critères d’acceptation en notation EARS (« Quand X, le système doit Y »), design.md avec l’approche technique, et tasks.md avec une liste de tâches numérotées. Lisez et corrigez chaque fichier avant de continuer : cette relecture est tout l’intérêt de la démarche. Ensuite, laissez Kiro traiter les tâches :

/spec run user-invitations

Les fichiers de spec sont du Markdown ordinaire. Versionnés, ils deviennent la documentation du changement suivant. Pour les changements plus modestes, le mode plan (Shift+Tab ou /plan) offre une version allégée de la même habitude.

Étape 9 : mode headless et CI

Pour les scripts et la CI, lancez Kiro sans l’interface de chat :

export KIRO_API_KEY=your-key
kiro-cli chat --v3 --no-interactive --trust-tools=read_file,grep_search "Summarize the risky changes in this branch"

--trust-tools liste les outils que Kiro peut utiliser sans demander (ces noms viennent de la V3, d’où le --v3 dans l’exemple, comme dans l’exemple GitHub Actions de la documentation). --trust-all-tools autorise tout : réservez-le à un sandbox. --require-mcp-startup fait échouer l’exécution si un serveur MCP ne démarre pas. Les clés d’API sont disponibles avec les offres Pro, Pro+, Pro Max et Power. Pour les éditeurs compatibles ACP, kiro-cli acp lance Kiro comme leur agent.

Pièges courants

• L’installeur échoue sous Windows. Vous êtes dans l’invite de commandes. Utilisez PowerShell ou Windows Terminal sous Windows 11.
• Le binaire ne démarre pas sur un vieux Linux. La glibc est antérieure à 2.34. Prenez le zip musl.
• Vos règles de steering sont ignorées. Le fichier utilise fileMatch ou auto, que la 2.x ne charge pas automatiquement, ou vous êtes dans un agent personnalisé sans la ressource de steering.
• Les crédits fondent vite. Un modèle coûteux ou un long chat. Regardez /usage, essayez Auto et utilisez /compact.
• Les commandes AWS ne marchent plus en V3. La V3 a retiré l’outil AWS intégré ; utilisez plutôt un serveur MCP AWS.
• Aucune option de clé d’API. Le mode headless demande une offre payante.

Kiro CLI ou un autre agent ?

Kiro convient bien si vous aimez planifier avec des specs, si votre entreprise gère déjà les accès via AWS IAM Identity Center, ou si vous voulez une seule facture pour les modèles premium et les modèles open-weight bon marché. Il convient moins si vous voulez apporter votre propre clé d’API ou utiliser des modèles locaux ; opencode le fait avec n’importe quel fournisseur. Si vous payez déjà Claude ou ChatGPT, Claude Code ou Codex CLI utilisent directement cet abonnement. Meilleures alternatives à Claude Code compare les principaux agents CLI côte à côte.

Faire tourner Kiro CLI à côté d’autres agents

Beaucoup d’équipes ne se limitent pas à un seul agent. Kiro écrit la spec, Claude Code ou Codex en construit une partie, un autre agent relit. Avec des onglets de terminal, tout ça devient vite confus. AgentVera est une application de bureau qui fait tourner ces CLI côte à côte dans de vrais terminaux, avec vos propres installations et connexions. La prise en charge de Kiro CLI fonctionne ainsi :

• Votre connexion Kiro. AgentVera ouvre kiro-cli chat dans un vrai terminal. Vous vous connectez avec kiro-cli login ; si vous êtes déconnecté, le terminal de l’agent vous demande de vous connecter.
• Modèle et effort par agent. Laissez le modèle vide pour le choix par défaut de Kiro, ou choisissez-en un par agent. L’effort va de bas à max.
• Des règles venues de vos fichiers. Kiro CLI n’a pas de flag d’instructions supplémentaires : les consignes durables viennent donc d’AGENTS.md ou des fichiers de règles du projet.
• Votre mcp.json reste le vôtre. Les serveurs MCP ajoutés dans AgentVera et le navigateur d’AgentVera sont fusionnés avec votre propre mcp.json Kiro à chaque lancement.
• Les sessions continuent. Quand vous reprenez un agent, il s’ouvre avec son ID de session ou la dernière session du dossier.
• Panneaux, flows et revue. Faites tourner Kiro dans la grille du workspace à côté de Claude Code ou Codex, chacun dans son propre git worktree. Les agents Kiro fonctionnent dans les flows, les messages groupés et les tâches planifiées, et reçoivent une revue de code automatique à la fin de chaque tour.

La grille, les worktrees, la revue de code et le gestionnaire MCP font partie de l’offre gratuite ; les flows sont inclus dans Pro et Team. Téléchargez AgentVera pour essayer.

En résumé

Pour utiliser Kiro CLI, installez-le, connectez-vous, lancez kiro-cli dans un projet et décrivez le changement. Laissez le modèle sur Auto tant que vous n’avez pas de raison de le changer, et gardez un œil sur /usage. Les règles du projet vont dans .kiro/steering/ ou AGENTS.md, les outils dans mcp.json, et les configurations récurrentes dans des agents personnalisés. Pour tout ce qui dépasse un correctif rapide, commencez par /spec new : relire des exigences et une liste de tâches avant que le code n’existe, c’est ce que Kiro fait de mieux.