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 amène de zéro à productif 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 :
| Commande | Ce qu'elle fait |
|---|---|
/help | Ouvre un panneau consultable de toutes les commandes |
/guide | Passe à l'agent Guide pour obtenir de l'aide sur Kiro lui-même |
/context | Affiche les fichiers présents dans le contexte et l'utilisation des jetons |
/model | Bascule entre les modèles d'IA |
/agent | Bascule entre les agents |
/chat new | Démarre une nouvelle conversation |
Kiro est livré avec des agents intégrés pour différentes tâches, et vous pouvez créer les vôtres :
Shift+Tab)/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 d'équipe et les observer travailler en temps réel.
Consultez Subagents et Custom agents 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 :
npm run) pour ne pas être interrompu lors des opérations courantes/tools trust <name> pour préapprouver des outils précis, ou /tools untrust <name> pour exiger une autorisation explicite/tools reset efface toutes les autorisations d'exécutionConsultez Permissions 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 MCP integration pour connecter votre premier serveur.
Shift+Enter pour saisir des requêtes multilignesShift+Tab pour passer en mode Plan (l'agent planifie avant d'agir)Esc pour annuler l'agent ou fermer n'importe quel panneau/help pour voir toutes les commandes disponiblesLa référence complète du clavier se trouve dans Terminal UI.
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 doctor pour cerner et résoudre les problèmes courants.
$ kiro-cli doctor ✔ Everything looks good! Kiro CLI still not working? Run kiro-cli issue to let us know!
Si votre sortie ne ressemble pas à la sortie attendue, suivez les invites pour résoudre votre problème.
Kiro CLI écrit des journaux à des emplacements propres à chaque plateforme :
| Plateforme | Chemin |
|---|---|
| macOS | $TMPDIR/kiro-log/kiro-chat.log |
| Linux | $XDG_RUNTIME_DIR/kiro-log/kiro-chat.log |
| Windows | %TEMP%\kiro-log\logs\kiro-chat.log |
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
kiro-cli login pour vous réauthentifier.kiro-cli doctor pour vérifier l'intégration au shell.kiro-cli doctor pour cerner et résoudre les problèmes courants.kiro-cli issue.Maintenant que vous êtes opérationnel, voici où approfondir vos connaissances :
/guide
Configuration et première exécution