Kiro CLI enregistre automatiquement toutes les sessions de clavardage à chaque tour de conversation. Les sessions sont stockées par répertoire dans la base de données, ce qui vous permet de reprendre n'importe quelle session précédente, d'exporter vers des fichiers ou d'intégrer des solutions de stockage personnalisées.
Automatique : chaque tour de conversation enregistré dans la base de données
Portée : par répertoire (chaque projet a ses propres sessions)
Stockage : base de données locale (~/.kiro/)
ID de session : UUID pour chaque session
# Resume most recent session kiro-cli chat --resume # Interactive picker kiro-cli chat --resume-picker # Resume a specific session by ID kiro-cli chat --resume-id <SESSION_ID> # List all sessions kiro-cli chat --list-sessions # Delete session kiro-cli chat --delete-session <SESSION_ID>
# Start a fresh conversation (saves current session automatically) /chat new # Start a fresh conversation with an initial prompt /chat new how do I set up a React project # Resume session (interactive) /chat resume # Print the current session ID /session-id # Save to file /chat save <path> # Load from file /chat load <path>
Le tableau de bord des sessions V3 regroupe les sessions locales et cloud de tous les espaces de travail dans une seule vue. Ouvrez-le avant de démarrer un clavardage ou depuis une session V3 active :
# Open the dashboard at launch kiro-cli chat --sessions # Open the dashboard from a V3 session /sessions
Parcourez les sessions à l'aide des touches fléchées et appuyez sur Enter pour reprendre la session sélectionnée. Les sessions locales d'un autre espace de travail vous demandent de confirmer le changement de répertoire avant leur chargement par Kiro. Les sessions cloud reprennent depuis le magasin cloud.
Commencez à taper n'importe où dans le tableau de bord pour effectuer une recherche. Le filtre immédiat recherche parmi les titres de session, les noms et les chemins des espaces de travail, les ID de session et les étiquettes ; faites précéder une étiquette de # pour filtrer selon celle-ci. Les requêtes de trois caractères ou plus recherchent également les titres de session indexés et les requêtes utilisateur dans les transcriptions locales V2 et V3.
La recherche dans le contenu des requêtes n'indexe pas les réponses de l'assistant ni la sortie des outils. Les sessions classiques et cloud correspondent toujours aux métadonnées de la liste, y compris leurs titres, mais les requêtes de leur transcription ne font pas partie de l'index de contenu local.
Sélectionnez une session et appuyez sur Ctrl+D pour la marquer pour suppression. Appuyez sur y pour confirmer ; toute autre touche annule l'opération. Vous ne pouvez pas supprimer la session active ni une session ouverte dans un autre terminal.
Pour examiner les sessions locales vides d'un espace de travail, sélectionnez sa ligne more et appuyez sur Ctrl+D. La vue de nettoyage exclut les sessions actives, verrouillées, récemment actives, marquées et dérivées, puis affiche les sessions candidates avant la suppression. Après avoir examiné la liste, appuyez de nouveau sur Ctrl+D, puis sur y pour confirmer.
Vous pouvez également exécuter le nettoyage directement :
# Show which empty local sessions would be deleted and which are exempt /sessions clean # Permanently delete the reported empty local sessions /sessions clean --yes
Le nettoyage est irréversible. Kiro analyse de nouveau les sessions avant leur suppression ; une session qui n'est plus vide n'est donc pas supprimée.
Le tableau de bord est une interface réservée à V3. /sessions n'est pas disponible dans V1 ou V2. kiro-cli chat --sessions sélectionne V3 lorsque vous n'avez pas choisi de moteur d'agent. Si vous transmettez explicitement un moteur autre que V3 ou enregistrez chat.agentEngine avec la valeur v1 ou v2, Kiro signale le conflit au lieu de changer silencieusement de moteur. Exécutez kiro-cli chat --v3 --sessions pour ce lancement ou modifiez le paramètre de moteur enregistré.
Les sessions démarrées avec --cloud s'exécutent dans un bac à sable cloud géré et sont stockées dans le magasin de sessions cloud de votre compte plutôt que dans la base de données locale par répertoire — consultez Sessions cloud. Elles apparaissent aux côtés des sessions locales dans --list-sessions et dans le sélecteur /sessions en cours de session, avec des colonnes indiquant l'environnement et l'état de chaque session.
--resume-id détecte automatiquement un ID de session cloud, donc aucun indicateur --cloud n'est nécessaire pour la reprendre — et comme la session réside dans le cloud, vous pouvez la reprendre à partir de n'importe quelle machine :
kiro-cli --resume-id <SESSION_ID>
/chat save et /chat load fonctionnent sur l'archive de session locale et ne sont pas disponibles dans les sessions cloud.
Utilisez des scripts personnalisés pour enregistrer ou charger des sessions depuis le contrôle de version, le stockage cloud ou des bases de données.
/chat save-via-script <script-path>
Le script reçoit le JSON de la session via stdin.
Exemple : enregistrer dans les Git Notes
#!/bin/bash COMMIT=$(git rev-parse HEAD) TEMP=$(mktemp) cat > "$TEMP" git notes --ref=kiro/notes add -F "$TEMP" "$COMMIT" --force rm "$TEMP" echo "Saved to commit ${COMMIT:0:8}" >&2
/chat load-via-script <script-path>
Le script produit le JSON de la session sur stdout.
Exemple : charger depuis les Git Notes
#!/bin/bash COMMIT=$(git rev-parse HEAD) git notes --ref=kiro/notes show "$COMMIT"
Base de données : sessions enregistrées automatiquement par répertoire
Fichiers : exportation manuelle via /chat save
Personnalisé : intégration basée sur des scripts
ID de session : format UUID (p. ex. f2946a26-3735-4b08-8d05-c928010302d5)
kiro-cli chat --resume
Poursuit la conversation la plus récente.
kiro-cli chat --resume-picker
Affiche une liste de sessions parmi lesquelles choisir. Les sessions V3 apparaissent avec un court titre généré par l'IA résumant votre première requête, ce qui facilite la distinction entre des sessions similaires.
/chat save backup.json
Exporte la session actuelle vers un fichier.
# Save to git notes /chat save-via-script ./scripts/save-to-git.sh # Load from git notes /chat load-via-script ./scripts/load-from-git.sh
Symptôme : « Failed to start session: Session is active in another process (PID XXXXX) »
Cause : vous essayez de reprendre une session déjà ouverte dans une autre fenêtre ou un autre onglet de terminal.
Solution : les sessions ne peuvent être actives que dans un seul processus à la fois afin d'éviter la corruption de la conversation. Vous avez deux options :
/chat save dans le terminal d'origine, puis /chat load dans le nouveau terminal. Cela crée une copie distincte que vous pouvez utiliser de façon indépendante.Symptôme : « No saved chat sessions »
Cause : aucune session dans le répertoire actuel
Solution : les sessions sont organisées par répertoire. Accédez au bon répertoire.
Symptôme : le script se termine avec une erreur
Cause : le script a retourné un code de sortie non nul
Solution : testez le script manuellement. Assurez-vous qu'il se termine avec le code 0 en cas de succès.
Symptôme : impossible de charger la session
Cause : le script n'a pas produit de JSON valide
Solution : testez que le script produit un JSON de session valide sur stdout.
Stockage : base de données SQLite dans ~/.kiro/
Portée : sessions indexées par chemin de répertoire
Enregistrement automatique : après chaque tour de conversation
Interface de script :
Gestion des sessions