Commandes CLI

Cette page fournit une référence complète pour toutes les commandes Kiro CLI et leurs arguments.

Ces arguments fonctionnent avec n'importe quelle commande Kiro CLI :

Lancez Kiro Crew ou transmettez des arguments à son interface de ligne de commande.

Syntaxe :

kiro-cli crew [--yes] [CREW_ARGUMENTS]...

Sur macOS et Linux, Kiro CLI propose d'installer Crew lorsqu'il n'est pas disponible. Kiro CLI utilise --yes ou -y pour installer sans l'invite. Il transmet tous les autres arguments après crew directement à Crew, sans séparateur --. Sur Windows, installez Crew séparément avant d'utiliser cette commande.

Exemples :

# Start the Crew gateway to get started
kiro-cli crew gateway

# Install when needed, skip the prompt, and start the gateway
kiro-cli crew --yes gateway

# Forward a Crew option directly
kiro-cli crew --version

Gérez les configurations d'agent. Le nom de l'agent est maintenant un argument positionnel pour create, edit et d'autres sous-commandes.

Syntaxe :

kiro-cli agent [SUBCOMMAND] [AGENT_NAME] [OPTIONS]

Sous-commandes :

Exemples :

kiro-cli agent list

# v1.26.0+: Agent name as positional argument
kiro-cli agent create my-agent
kiro-cli agent edit my-agent
kiro-cli agent edit  # Defaults to current agent

# Previous syntax (still supported)
kiro-cli agent validate ./my-agent.json
kiro-cli agent set-default my-agent

Nouveauté dans la v1.26.0 :

• Le nom de l'agent est maintenant un argument positionnel (p. ex. kiro-cli agent create my-agent au lieu de --name my-agent)
• La commande edit modifie par défaut l'agent actuel lorsqu'aucun argument n'est fourni

Démarrez une session de clavardage interactive avec Kiro. Lorsqu'aucune sous-commande n'est spécifiée, kiro utilise par défaut kiro-cli chat.

Syntaxe :

kiro-cli chat [OPTIONS] [INPUT]

Arguments :

Exemples :

# Start interactive chat
kiro-cli 

# Ask a question directly
kiro-cli chat "How do I list files in Linux?"

# Non-interactive mode with trusted tools
kiro-cli chat --no-interactive --trust-all-tools "Show me the current directory"

# Resume previous conversation
kiro-cli chat --resume

# Resume a specific session by ID
kiro-cli chat --resume-id abc123-def456

# Open session picker to choose which session to resume
kiro-cli chat --resume-picker

# List all saved sessions
kiro-cli chat --list-sessions

# List available models (plain text)
kiro-cli chat --list-models

# List available models (JSON output for scripting)
kiro-cli chat --list-models --format json

# Use specific agent
kiro-cli chat --agent my-agent "Help me with AWS CLI"

# Set the initial reasoning effort level at launch
kiro-cli chat --effort high "Refactor this module for testability"

Traduisez des instructions en langage naturel en commandes shell exécutables grâce à l'IA.

Syntaxe :

kiro-cli translate [OPTIONS] [INPUT...]

Arguments :

Exemples :

kiro-cli translate "list all files in the current directory"
kiro-cli translate "find all Python files modified in the last week"
kiro-cli translate "compress all log files older than 30 days"
kiro-cli translate -n 3 "search for text in files"

Diagnostiquez et corrigez les problèmes courants d'installation et de configuration.

Syntaxe :

kiro-cli doctor [OPTIONS]

Arguments :

Exemples :

kiro-cli doctor
kiro-cli doctor --all
kiro-cli doctor --strict

Mettez à jour Kiro CLI vers la dernière version.

Syntaxe :

kiro-cli update [OPTIONS]

Arguments :

Exemples :

kiro-cli update
kiro-cli update --non-interactive

Obtenez ou définissez le thème visuel pour le menu déroulant de saisie automatique.

Syntaxe :

kiro-cli theme [OPTIONS] [THEME]

Arguments :

Exemples :

kiro-cli theme --list
kiro-cli theme dark
kiro-cli theme light
kiro-cli theme system

Gérez les intégrations système pour Kiro.

Syntaxe :

kiro-cli integrations [SUBCOMMAND] [OPTIONS]

Sous-commandes :

Options :

• --silent / -s : Supprimer les messages d'état
• --format / -f : Format de sortie (pour la commande status)

Exemples :

# Install kiro command router (v1.26.0+)
kiro-cli integrations install kiro-command-router

# Check integration status
kiro-cli integrations status

# Uninstall silently
kiro-cli integrations uninstall --silent

Le kiro command router est un point d'entrée unifié qui achemine la commande kiro entre le CLI et l'IDE selon votre préférence.

Problème qu'il résout : Par défaut, la commande kiro lance Kiro IDE. Beaucoup d'utilisateurs préfèrent qu'elle lance le CLI, car ils utilisent l'icône de l'application pour ouvrir l'IDE.

Installation :

# Install the router
kiro-cli integrations install kiro-command-router

# Set CLI as the default
kiro set-default cli

# Or set IDE as the default
kiro set-default ide

Après l'installation :

• kiro - Lance votre valeur par défaut (CLI ou IDE)
• kiro-cli - Lance toujours le CLI
• kiro ide - Lance toujours l'IDE

Cas d'usage :

• Flux de travail axés sur le CLI où vous utilisez principalement le terminal
• Accès rapide au CLI sans avoir à taper kiro-cli chaque fois
• Flexibilité pour changer les valeurs par défaut selon votre projet ou flux de travail actuel

Gérez les suggestions en ligne (texte fantôme) qui apparaissent pendant la saisie.

Syntaxe :

kiro-cli inline [SUBCOMMAND] [OPTIONS]

Sous-commandes :

Exemples :

kiro-cli inline enable
kiro-cli inline disable
kiro-cli inline status
kiro-cli inline set-customization
kiro-cli inline show-customizations --format json

Authentifiez-vous auprès du service Kiro CLI à l'aide de Builder ID, d'Identity Center ou d'une connexion sociale (Google, GitHub).

Syntaxe :

kiro-cli login [OPTIONS]

Options :

Méthodes d'authentification :

Environnement local :

• Ouvre le navigateur pour le portail d'authentification unifié
• Sélectionnez la méthode d'authentification de manière interactive
• Les indicateurs de sélection de connexion (p. ex. --license, --social) sont généralement ignorés localement; le flux du navigateur contrôle la méthode

Environnement distant (SSH/Terminal) :

• Utilise automatiquement le flux d'appareil
• Affiche le code d'appareil et l'URL
• Terminez l'authentification sur un autre appareil
• Le CLI interroge jusqu'à l'achèvement

Exemples :

# Basic login (opens browser locally, shows device code remotely)
kiro-cli login

# Identity Center login
kiro-cli login --license pro --identity-provider https://my-org.awsapps.com/start --region us-east-1

# Social login
kiro-cli login --social google

# Force device flow (useful for SSH sessions)
kiro-cli login --use-device-flow

Résolution de problèmes :

• Erreur déjà connecté : Déconnectez-vous d'abord avec kiro-cli logout
• Le navigateur ne s'ouvre pas : Utilisez l'indicateur --use-device-flow
• Délai d'authentification dépassé : Redémarrez le processus de connexion
• Identity Center échoue : Vérifiez l'URL et la région avec votre administrateur

Déconnectez-vous du service Kiro CLI et effacez les identifiants d'authentification.

Syntaxe :

kiro-cli logout

Options :

Ce qui est effacé :

• Jetons d'authentification
• Identifiants de session
• Informations de profil utilisateur

Ce qui est conservé :

• Configurations d'agent
• Conversations enregistrées
• Paramètres
• Configurations de serveur MCP

Exemple :

kiro-cli logout

Sortie :

You are now logged out
Run kiro-cli login to log back in to Kiro CLI

Remarque : La déconnexion s'applique à l'ensemble de l'utilisateur et affecte tous les espaces de travail.

Affichez les informations sur l'utilisateur actuel et l'état d'authentification, y compris votre adresse courriel pour les types de connexion Builder ID, IAM Identity Center et connexion sociale.

Syntaxe :

kiro-cli whoami [OPTIONS]

Options :

Informations de sortie :

• Nom d'utilisateur/ID utilisateur
• Méthode d'authentification (Builder ID, Identity Center, connexion sociale)
• État de la session
• Informations de profil

Exemples :

# Check current user
kiro-cli whoami
# Logged in with Builder ID
# Email: user@example.com

kiro-cli whoami --format json
kiro-cli whoami --format json-pretty

Exemple de sortie (Identity Center) :

Logged in with IAM Identity Center (https://my-org.awsapps.com/start)

Profile:
Q-Dev-Amazon-Profile
arn:aws:codewhisperer:us-east-1:...:profile/...

Exemple de sortie (Builder ID) :

Logged in with Builder ID

Profile:
builder-id-username

Résolution de problèmes :

• Erreur non connecté : Connectez-vous avec kiro-cli login

Gérez les paramètres de configuration de kiro-cli.

Syntaxe :

kiro-cli settings [SUBCOMMAND] [OPTIONS] [KEY] [VALUE]

Arguments :

Sous-commandes :

Exemples :

# View all settings
kiro-cli settings list

# View all available settings
kiro-cli settings list --all

# Get a specific setting
kiro-cli settings telemetry.enabled

# Set a setting
kiro-cli settings telemetry.enabled true

# Delete a setting
kiro-cli settings --delete chat.defaultModel

# Open settings file
kiro-cli settings open

# JSON output
kiro-cli settings list --format json-pretty

Exécutez des tests de diagnostic et générez un rapport d'informations système pour la résolution de problèmes.

Syntaxe :

kiro-cli diagnostic [OPTIONS]

Options :

Le format plain génère du texte au format Markdown.

Comportement :

• Sans --force : Nécessite que l'application Kiro CLI soit en cours d'exécution (utilisez d'abord kiro-cli launch). Génère des diagnostics complets en se connectant à l'application en cours d'exécution.
• Avec --force : Commande autonome qui fonctionne sans que l'application soit en cours d'exécution. Génère des diagnostics limités mais plus rapides.

Informations de sortie :

Le rapport de diagnostic comprend :

• Informations système (SE, architecture, mémoire)
• Version de Kiro CLI et détails de construction
• État de la configuration
• Variables d'environnement
• Dépendances installées
• Problèmes potentiels

Exemples :

# Generate full diagnostic report
kiro-cli diagnostic

# JSON output
kiro-cli diagnostic --format json-pretty

# Limited output (faster)
kiro-cli diagnostic --force

Exemple de sortie (format TOML) :

[q-details]
version = "1.23.0"
hash = "97d58722cd90f6d3dda465f6462ee4c6dc104b22"
date = "2025-12-18T16:49:27.015389Z (4d ago)"
variant = "full"

[system-info]
os = "macOS 15.7.1 (24G231)"
chip = "Apple M1 Pro"
total-cores = 10
memory = "32.00 GB"

[environment]
cwd = "/Users/user/project"
cli-path = "/Users/user/.cargo/bin/kiro-cli"
os = "Mac"
shell-path = "/bin/bash"
shell-version = "5.1.16"
terminal = "iTerm2"
install-method = "cargo"

[env-vars]
PATH = "..."
SHELL = "/bin/zsh"
TERM = "xterm-256color"

Résolution de problèmes :

• Erreur « Kiro CLI app is not running » : Lancez l'application avec kiro-cli launch ou utilisez l'indicateur --force pour un diagnostic autonome
• Le diagnostic reste bloqué : Utilisez --force pour une sortie limitée plus rapide
• Erreurs de permission : Exécutez avec les permissions appropriées ou ignorez les erreurs

Cas d'usage :

• Résolution des problèmes d'installation
• Fournir des informations au soutien
• Vérifier la configuration de l'environnement
• Vérifier les problèmes potentiels

Créez une issue GitHub pour des commentaires ou des rapports de bogue.

Syntaxe :

kiro-cli issue [OPTIONS] [DESCRIPTION...]

Arguments :

Exemples :

kiro-cli issue
kiro-cli issue "Autocomplete not working in zsh"

Affichez les informations de version et le journal des modifications.

Syntaxe :

kiro-cli version [OPTIONS]

Arguments :

Exemples :

kiro-cli version
kiro-cli version --changelog
kiro-cli version --changelog=all
kiro-cli version --changelog=1.5.0

Gérez les serveurs Model Context Protocol (MCP).

Syntaxe :

kiro-cli mcp [SUBCOMMAND] [OPTIONS]

Sous-commandes :

Ajoutez ou remplacez un serveur MCP configuré.

Arguments :

Exemple :

kiro-cli mcp add --name my-server --command "node server.js" --scope workspace

Supprimez un serveur MCP.

Arguments :

Exemple :

kiro-cli mcp remove --name my-server --scope workspace

Affichez la liste des serveurs MCP configurés.

Syntaxe :

kiro-cli mcp list [SCOPE]

Exemple :

kiro-cli mcp list
kiro-cli mcp list workspace
kiro-cli mcp list global

Importez la configuration d'un serveur à partir d'un fichier.

Arguments :

Exemple :

kiro-cli mcp import --file config.json workspace

Obtenez l'état d'un serveur MCP.

Arguments :

Exemple :

kiro-cli mcp status --name my-server

Kiro CLI enregistre automatiquement toutes les sessions de clavardage à chaque tour de conversation. Vous pouvez reprendre n'importe quelle session de clavardage précédente à tout moment.

# Resume the most recent chat session
kiro-cli chat --resume

# Interactively pick a chat session to resume
kiro-cli chat --resume-picker

# List all saved chat sessions for the current directory
kiro-cli chat --list-sessions

# Delete a saved chat session
kiro-cli chat --delete-session <SESSION_ID>

Utilisez la commande /chat pour gérer les sessions :

# Start a fresh conversation (saves current session automatically)
/chat new

# Start a fresh conversation with an initial prompt
/chat new <PROMPT>

# Resume a chat session (interactive selector)
/chat resume

# Save current session to a file
/chat save <FILE_PATH>

# Load a session from a file
/chat load <FILE_PATH>

L'extension .json est optionnelle lors du chargement - Kiro essaiera avec et sans l'extension.

Vous pouvez utiliser des scripts personnalisés pour contrôler l'emplacement où les sessions de clavardage sont enregistrées et chargées. Cela vous permet de stocker les sessions dans des systèmes de contrôle de version, du stockage cloud, des bases de données ou tout autre emplacement personnalisé.

# Save session via custom script (receives JSON via stdin)
/chat save-via-script <SCRIPT_PATH>

# Load session via custom script (outputs JSON to stdout)
/chat load-via-script <SCRIPT_PATH>

Conseils :

• Les ID de session sont des UUID qui identifient de manière unique chaque session de clavardage
• Les sessions sont stockées par répertoire, donc chaque projet a son propre ensemble de sessions
• Les sessions les plus récemment mises à jour apparaissent en premier dans la liste

Kiro CLI conserve des fichiers journaux pour la résolution de problèmes :

Emplacements :

• macOS : $TMPDIR/kiro-log/
• Linux : $XDG_RUNTIME_DIR ou /tmp/kiro-log/

Variables d'environnement :

Contrôlez la journalisation et le répertoire d'accueil de Kiro avec ces variables d'environnement :

Niveaux de journalisation :

Défini via la variable d'environnement KIRO_LOG_LEVEL :

• error : Seulement les erreurs (par défaut)
• warn : Avertissements et erreurs
• info : Infos, avertissements et erreurs
• debug : Informations de débogage et plus
• trace : Tous les messages, y compris les traces détaillées

Exemples :

# Enable debug logging
export KIRO_LOG_LEVEL=debug
kiro-cli chat

# Disable colored output (useful for CI/CD, v1.26.0+)
export KIRO_LOG_NO_COLOR=1
kiro-cli chat

# Combined
export KIRO_LOG_LEVEL=debug
export KIRO_LOG_NO_COLOR=true
kiro-cli chat

# For fish shell
set -x KIRO_LOG_LEVEL debug
set -x KIRO_LOG_NO_COLOR 1
kiro-cli chat

Nouveauté dans la v1.26.0 : La variable d'environnement KIRO_LOG_NO_COLOR permet de désactiver la sortie de journal colorée, utile pour les pipelines CI/CD et le traitement des fichiers journaux.

Avertissement : Les fichiers journaux peuvent contenir des informations sensibles, y compris des chemins de fichiers, des extraits de code et des sorties de commande. Soyez prudent lors du partage des journaux.

• Référence des commandes slash
• Configuration des paramètres
• Installation et résolution de problèmes