Mode sans interface

Le mode sans interface vous permet d'exécuter Kiro CLI dans le cadre de votre pipeline CI/CD pour automatiser les revues de code, générer des tests ou résoudre les échecs de build — aucun terminal interactif requis. Authentifiez-vous avec une clé API, transmettez une requête, et Kiro l'exécute de bout en bout.

Le mode sans interface nécessite une clé API définie comme variable d'environnement KIRO_API_KEY. Si vous n'en avez pas encore créé une, suivez les étapes dans Générer une clé API.

Pour plus de détails sur la préséance de l'authentification et la vérification de vos identifiants actifs, consultez Authentification.

Transmettez --no-interactive avec votre instruction initiale. L'instruction peut être fournie comme argument positionnel ou via l'entrée standard (stdin). Lorsque l'entrée standard est redirigée et qu'aucun argument positionnel n'est fourni, Kiro lit l'intégralité du flux comme instruction :

# Positional argument
kiro-cli chat --no-interactive "your prompt here"

# Stdin only: pipe the entire instruction
printf '%s\n' "your prompt here" | kiro-cli chat --no-interactive

Puisqu'il n'y a aucun utilisateur pour approuver les appels d'outils, utilisez --trust-all-tools ou --trust-tools pour accorder les autorisations à l'avance :

# Trust all tools
kiro-cli chat --no-interactive --trust-all-tools "Write tests for the auth module and run them"

# Trust only specific tool categories
kiro-cli chat --no-interactive --trust-tools=read,grep "Find all TODO comments in src/"

name: Kiro Code Review
on: [pull_request]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install Kiro CLI
        run: curl -fsSL https://cli.kiro.dev/install | bash
      - name: Review PR changes
        env:
          KIRO_API_KEY: ${{ secrets.KIRO_API_KEY }}
        run: kiro-cli chat --no-interactive --trust-tools=read,grep "Review the changes in this PR for security issues"

# Generate and run tests
kiro-cli chat --no-interactive --trust-all-tools "Write tests for the auth module and run them"

# Troubleshoot a failing build with the full instruction on stdin
{
  printf '%s\n\n' "Explain this build failure and suggest a fix:"
  cat build-error.log
} | kiro-cli chat --no-interactive --trust-tools=read

Utilisez --require-mcp-startup lorsqu'une exécution non interactive dépend des outils MCP. V2 et V3 attendent les serveurs MCP configurés avant de soumettre l'instruction. Dans V3, Kiro se termine avec le code 3 si un serveur échoue, si son état de démarrage ne peut pas être déterminé ou s'il ne signale aucun état dans les 30 secondes. Sans l'option, Kiro consigne les problèmes de démarrage MCP et poursuit l'exécution. Consultez les codes de sortie pour gérer les échecs dans les scripts.

Transmettez --agent <name> pour exécuter une commande non interactive avec un agent précis. Sans --agent, une nouvelle exécution V3 utilise chat.defaultAgent s'il est configuré, puis revient à l'agent intégré par défaut. Sans modèle explicite, une nouvelle exécution V3 applique chat.defaultModel lorsqu'il est configuré; un agent sélectionné qui spécifie un modèle peut le remplacer. V2 détermine son agent et son modèle par défaut à l'interne.

kiro-cli settings chat.defaultAgent my-project-agent
kiro-cli chat --v3 --no-interactive "Write tests for the auth module"  # runs on my-project-agent

Transmettez --model <id> pour fixer le modèle d'une exécution. Sur V2 et V3, une valeur explicite remplace le modèle configuré de l'agent sélectionné ; sur V3, elle remplace également chat.defaultModel, et sur V2, elle remplace le modèle enregistré d'une session reprise. V2 supprime les espaces en début et en fin avant de transmettre au backend un ID non vide qui ne figure pas dans la liste ; une valeur vide ne transmet aucun remplacement et laisse la sélection de modèle actuelle inchangée. Sans --model, une session reprise conserve son agent et son modèle d'origine.

Transmettez --effort <level> pour définir l'effort de raisonnement d'une exécution non interactive. Les niveaux pris en charge dépendent du modèle sélectionné. Dans V3, l'indicateur s'applique uniquement à la session démarrée par Kiro et ne modifie pas la valeur par défaut enregistrée pour chaque modèle.

Transmettez --output-format stream-json pour recevoir les événements d'exécution sous forme de JSON Lines sur la sortie standard. Chaque ligne est un objet JSON autonome, ce qui facilite son traitement dans les scripts, les pipelines de journalisation et les tâches CI par rapport au texte mis en forme.

kiro-cli chat --no-interactive --trust-all-tools --output-format stream-json "Summarize open TODOs in src/"

--output-format stream-json nécessite V2 ou V3 (--agent-engine v2 ou --agent-engine v3).

En V3, une exécution non interactive interrompue écrit un enregistrement d'interruption final dans stream-json. Traitez cet enregistrement final comme la fin de l'exécution interrompue plutôt que d'attendre un autre enregistrement de fin d'exécution.

• Stockez KIRO_API_KEY comme secret dans votre plateforme CI/CD — ne l'inscrivez jamais en dur dans les configurations de pipeline ni ne la validez dans le contrôle des sources.
• Utilisez --trust-tools avec des catégories spécifiques plutôt que --trust-all-tools afin de respecter le principe du moindre privilège.
• Ajoutez --require-mcp-startup lorsque votre pipeline dépend de serveurs MCP, afin que la tâche s'arrête avant de commencer plutôt que de s'exécuter sans les outils attendus.
• Avec V2 ou V3, fournissez votre instruction comme argument positionnel ou transmettez-la via l'entrée standard (stdin), mais pas les deux. V2 et V3 ne lisent l'entrée standard que lorsqu'aucun argument positionnel n'est présent.
• Vérifiez les codes de sortie dans votre pipeline pour gérer les échecs de façon élégante.
• Renouvelez régulièrement vos clés API et révoquez celles qui ne sont plus utilisées depuis le portail Kiro.

• Vous devez fournir une instruction initiale non vide, soit comme argument positionnel, soit via l'entrée standard (stdin).
• Aucune saisie utilisateur en cours de session n'est possible.
• Les commandes à barre oblique interactives (sélecteur /model, sélecteur /agent) ne sont pas disponibles.
• Les fonctionnalités de l'interface utilisateur du terminal sont désactivées.

• Authentification — Configuration des clés API et méthodes d'authentification
• Codes de sortie — Gérer les échecs dans les scripts
• Commandes CLI — Référence complète des indicateurs CLI