Configuration et première exécution

Kiro CLI est un agent de programmation IA qui vit dans votre terminal — il lit votre code source, écrit du code, exécute des commandes et demande une confirmation avant de faire quoi que ce soit de destructeur. Ce guide vous permet de partir de zéro et de programmer efficacement en environ cinq minutes.

Si vous n'avez pas encore effectué l'installation, exécutez la commande d'installation depuis la page d'installation et complétez l'authentification par navigateur. Puis revenez ici.

Kiro CLI dispose d'un agent guide intégré qui connaît tout sur l'interface CLI — commandes, outils, paramètres, flux de travail et bonnes pratiques. Plutôt que de lire la documentation, vous pouvez simplement lui poser des questions.

Après avoir lancé une session, tapez :

> /guide

Puis engagez une conversation :

[guide] > What can you help me with?

[guide] > How should I set up this project to work well with Kiro?

[guide] > What's the best way to do code reviews with Kiro?

[guide] > How do I connect my GitHub account?

L'agent Guide s'appuie sur une documentation indexée qui correspond à votre version installée. Il peut aussi créer des fichiers de configuration pour vous — des agents, des requêtes et des fichiers de steering — directement à partir de la conversation.

Appuyez sur Shift+Tab pour revenir à votre agent principal lorsque vous êtes prêt à commencer à travailler.

Accédez à n'importe quel répertoire de projet et lancez Kiro :

cd my-project
kiro-cli

L'interface utilisateur du terminal s'ouvre — une interface de clavardage riche avec coloration syntaxique, panneaux interactifs et suivi visuel de la progression des outils. Vous discutez maintenant avec un agent IA capable de lire, d'écrire et d'exécuter des commandes dans votre projet.

Tapez naturellement. Kiro comprend le contexte de votre projet et peut agir :

> Explain the architecture of this project

> Find all TODO comments and summarize them

> Write a unit test for the auth module

> Refactor the database connection to use connection pooling

Kiro lit vos fichiers, exécute des commandes et effectue des modifications — en demandant une autorisation avant toute action destructrice.

Pointez Kiro vers des fichiers précis à l'aide de @ avec complétion par tabulation :

> Review @src/api/routes.ts for security issues

Appuyez sur Shift+Tab pour passer en mode Plan. Kiro décrit ce qu'il a l'intention de faire avant d'apporter des modifications — utile lorsque vous voulez d'abord revoir l'approche.

[plan] > Migrate the Express routes to use async/await error handling

L'agent produit un plan structuré avec des étapes. Lorsque vous êtes satisfait, il passe en mode d'exécution et effectue le travail.

Faites précéder d'un ! pour exécuter des commandes sans passer par l'agent :

!npm run build

Lorsque Kiro veut exécuter une commande ou écrire dans un fichier, une invite d'approbation s'affiche. Appuyez sur y pour approuver, n pour rejeter, ou Tab pour explorer les options et donner de la rétroaction.

Par défaut, Kiro lit vos fichiers et déduit le contexte. Mais vous pouvez le rendre nettement plus intelligent en lui indiquant les conventions de votre projet. Créez un fichier de steering :

mkdir -p .kiro/steering

Ajoutez .kiro/steering/project.md :

# Project Context

- This is a TypeScript project using Next.js 15
- Use pnpm for package management
- Follow the existing code style (Prettier + ESLint)
- Write tests with Vitest
- Prefer functional components with hooks

Kiro lit automatiquement les fichiers de steering et suit vos directives dans chaque réponse. La différence est immédiate — les réponses correspondent à votre pile technologique, à vos conventions et à vos préférences.

Consultez Steering pour le guide complet sur la rédaction de fichiers de steering efficaces.

Les commandes à barre oblique contrôlent votre session. Tapez / et l'interface TUI affiche des suggestions de complétion automatique. Voici celles que vous utiliserez le plus souvent :

Kiro est livré avec des agents intégrés pour différentes tâches, et vous pouvez créer les vôtres :

• Agent Default — assistant de programmation à usage général
• Agent Plan — décompose les tâches complexes en plans structurés (Shift+Tab)
• Agent Guide — répond aux questions sur Kiro CLI lui-même (/guide)

Créez des agents personnalisés pour les flux de travail récurrents — révision de code, rédaction de tests, déploiement, ou toute autre tâche propre à votre équipe :

> /guide Create an agent for code review

L'agent Guide génère un fichier .kiro/agents/code-review.yaml. Basculez-y à tout moment avec /agent swap code-review.

Pour les tâches plus importantes, Kiro peut créer des sous-agents qui travaillent en parallèle avec un contexte isolé. Appuyez sur Ctrl+G pour ouvrir le moniteur de Crew et les observer travailler en temps réel.

Consultez Sous-agents et Agents personnalisés pour le guide complet.

Au-delà du flux d'approbation par action, vous disposez d'un contrôle précis sur ce que Kiro peut faire :

• Motifs de confiance — approuvez une commande une seule fois, ou faites confiance à un motif (p. ex., toutes les commandes npm run) pour ne pas être interrompu lors des opérations courantes
• Autorisations des outils — utilisez /tools trust <name> pour approuver à l'avance des outils précis, ou /tools untrust <name> pour exiger une autorisation explicite
• Réinitialisation à tout moment — /tools reset efface toutes les autorisations d'exécution

Consultez Autorisations pour le modèle de confiance complet.

Kiro prend en charge le Model Context Protocol (MCP), qui lui permet d'interagir directement avec des bases de données, des API, GitHub et d'autres services. Une fois que vous avez configuré un serveur MCP, vous pouvez demander des choses comme « énumère mes pull requests ouvertes » ou « interroge la base de données de préproduction ».

Consultez Intégration MCP pour connecter votre premier serveur.

• Appuyez sur Shift+Enter pour saisir des requêtes sur plusieurs lignes
• Appuyez sur Shift+Tab pour passer en mode Plan (l'agent planifie avant d'agir)
• Appuyez sur Esc pour annuler l'agent ou fermer n'importe quel panneau
• Tapez /help pour voir toutes les commandes disponibles

La référence complète du clavier se trouve dans Interface utilisateur du terminal.

Kiro CLI (v1.8.0+) respecte les variables d'environnement de proxy standards. Définissez-les dans votre shell :

export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080
export NO_PROXY=localhost,127.0.0.1,.company.com

Pour les proxys nécessitant une authentification :

export HTTPS_PROXY=http://username:password@proxy.company.com:8080

Si vous avez un problème avec Kiro CLI, exécutez kiro-cli diagnostic. Cette commande affiche votre version de Kiro CLI, les renseignements sur le système et l'environnement.

Pour signaler le problème, exécutez kiro-cli issue. Cette commande ouvre un formulaire de signalement GitHub dans votre navigateur, avec le rapport de diagnostic déjà rempli. Par SSH, dans CloudShell ou dans WSL, kiro-cli issue affiche l'URL du signalement au lieu de l'ouvrir. Elle affiche aussi l'URL si le navigateur ne s'ouvre pas.

Kiro CLI écrit des journaux à des emplacements propres à chaque plateforme :

Remplacez le chemin des journaux à l'aide de la variable d'environnement KIRO_CHAT_LOG_FILE :

KIRO_CHAT_LOG_FILE=/tmp/my-debug.log kiro-cli chat

Sous Windows (PowerShell) :

$env:KIRO_CHAT_LOG_FILE = "C:\temp\my-debug.log"
kiro-cli chat

• Le répertoire personnel se remplit au démarrage : Dans les environnements à stockage limité comme CloudShell, définissez KIRO_SKIP_BINARY_PINNING=1 uniquement lorsque le fichier binaire Kiro installé demeure dans un chemin fixe et stable. Cela évite de créer une copie du fichier binaire propre à la session. N'utilisez pas cette option si un programme d'installation peut remplacer ou supprimer le fichier binaire pendant la session.
• Le moteur d'exécution intégré remplit le répertoire personnel : Dans Kiro CLI 2.37 ou une version ultérieure, définissez KIRO_RUNTIME_DIR sur un chemin absolu pour y extraire le moteur d'exécution intégré de Kiro au lieu de votre répertoire personnel. Une valeur relative ou vide est ignorée. Pour le confirmer, démarrez kiro-cli chat et vérifiez que le répertoire contient maintenant le moteur d'exécution.
• Échecs d'authentification — Exécutez kiro-cli login pour vous authentifier de nouveau.

1. Exécutez kiro-cli diagnostic pour vérifier votre version de Kiro CLI, les renseignements sur le système et l'environnement.
2. Vérifiez votre connexion Internet.
3. Vérifiez que vous utilisez un environnement pris en charge. Consultez Commandes CLI pour connaître les shells pris en charge.
4. Essayez de réinstaller Kiro CLI depuis la page d'installation.
5. Si le problème persiste, signalez-le à l'aide de kiro-cli issue.

Maintenant que vous êtes opérationnel, voici où approfondir vos connaissances :

• Interface utilisateur du terminal — Référence complète de l'interface de clavardage, des thèmes et des panneaux
• Steering — Guidez Kiro avec du contexte et des conventions propres à votre projet
• Agents personnalisés — Créez des agents spécialisés pour vos flux de travail
• MCP — Connectez des outils et des sources de données externes
• Hooks — Automatisez des actions avant et après les commandes
• Mode sans interface — Exécutez Kiro de manière non interactive dans des pipelines CI/CD
• Agent Guide — Posez à tout moment des questions à Kiro sur ses propres fonctionnalités avec /guide