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 pour échouer rapidement si les serveurs MCP ne peuvent pas se connecter — utile pour les pipelines qui dépendent d'outils externes. Consultez codes de sortie pour la gestion des échecs dans les scripts.

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 pour échouer rapidement plutôt que de rester bloqué.
• 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