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
Kiro limite au propriétaire l'accès à son état dans le répertoire personnel et aux données des sessions précédentes. Cela protège l'historique des conversations locales et l'état connexe contre les autres comptes sur la même machine.
# 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>
Dans V3, --resume sélectionne la session la plus récente qui correspond au mode de lancement actuel : un lancement local reprend la session locale correspondante la plus récente, tandis qu'un lancement dans le nuage reprend la session dans le nuage correspondante la plus récente.
Dans l'interface utilisateur du terminal, si --resume-id ne correspond pas à une session locale, Kiro ne démarre plus silencieusement une conversation de remplacement. Lorsque les sessions dans le nuage informatique sont activées et que vous fournissez un ID de session complet, Kiro consulte le magasin de sessions à distance avant de signaler que l'ID n'a pas pu être résolu.
# 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>
Chaque étape de workflow déclaratif possède une session d'agent sous-jacente, mais gérez l'exécution et ses étapes au moyen de /workflow, et non du flux ordinaire /chat resume. Ouvrez le moniteur de l'exécution, sélectionnez une étape en pause, puis appuyez sur s pour envoyer une réponse textuelle dans la session de cette étape.
Ne présumez pas qu'une session d'étape sous-jacente peut être recherchée, exportée ou reprise indépendamment au moyen de /sessions. Consultez Exécuter et gérer les workflows.
Le tableau de bord des sessions V3 regroupe les sessions locales et les sessions dans le nuage informatique dans une seule vue. Par défaut, il affiche les sessions du répertoire actuel; désactivez le filtre current workspace only pour voir les sessions de tous les espaces de travail. 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 dans le nuage informatique reprennent depuis le magasin de sessions dans le nuage informatique.
Appuyez sur Tab pour déplacer le focus entre les commandes et les résultats de session. Utilisez ←/→ pour passer entre Search, Filter, Sort et Group ; la commande qui a le focus affiche ses options en ligne. Utilisez ↑/↓ pour parcourir les options, appuyez sur Space pour activer ou désactiver un filtre et appuyez sur Enter pour revenir à la liste. Appuyez sur Ctrl+X pour réinitialiser les filtres : current workspace only activé et tous les autres filtres désactivés.
Par défaut, les sessions s'affichent dans une liste non groupée triée selon last used. Triez selon last used, session name ou messages, et regroupez selon workspace, recency, status lorsqu'il est disponible, ou none. Kiro mémorise le dernier ordre de tri que vous choisissez.
Utilisez la commande Filter pour combiner les filtres current workspace only, main sessions et bookmarked. current workspace only est activé par défaut, et Kiro retient si vous le laissez activé ou le désactivez dans le paramètre chat.sessionDashboard.scope. Si le répertoire actuel ne contient aucune session, le tableau de bord affiche temporairement tous les espaces de travail sans modifier votre choix de filtre enregistré. includes empty révèle les sessions vides, qui sont masquées par défaut. main sessions conserve les sessions racines et autonomes tout en masquant les sessions enfants créées par Tangent, rewind et les sous-agents.
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 le contenu de session indexé dans les transcriptions locales V2 et V3.
Par défaut, l'index de contenu couvre vos requêtes et les réponses de l'agent. Exécutez /settings dans une session V3 et choisissez Session search pour basculer entre Prompts only et Prompts and agent responses ; ce choix est enregistré sous chat.sessionDashboard.indexResponses. La sortie des outils n'est indexée dans aucun des deux modes. Si votre index local ne couvre actuellement que les requêtes, /sessions vous demande une confirmation avant de le reconstruire pour y inclure les réponses. Les sessions classiques et les sessions dans le nuage informatique correspondent toujours aux métadonnées de la liste (titres, espace de travail, ID de session et étiquettes), mais le contenu de leur transcription ne fait 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 harnais d'agent. Si vous transmettez explicitement un harnais autre que V3 ou enregistrez chat.agentEngine avec la valeur v1 ou v2, Kiro signale le conflit au lieu de changer silencieusement. Exécutez kiro-cli chat --v3 --sessions pour ce lancement ou modifiez le paramètre enregistré. Pour exécuter une seule session sur le harnais V2 malgré cette valeur enregistrée, transmettez --v2.
Les sessions démarrées avec --cloud s'exécutent dans un bac à sable géré dans le nuage informatique et sont stockées dans le magasin de sessions dans le nuage informatique de votre compte plutôt que dans la base de données locale par répertoire — consultez Sessions dans le nuage informatique. 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 dans le nuage informatique, donc aucun indicateur --cloud n'est nécessaire pour la reprendre — et comme la session réside dans le nuage informatique, 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 dans le nuage informatique.
Utilisez des scripts personnalisés pour enregistrer ou charger des sessions depuis le contrôle de version, le stockage dans le nuage informatique 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.
/settings pour n'indexer que les requêtes. La sortie des outils, les transcriptions des sessions classiques et celles des sessions dans le nuage informatique ne sont pas indexées ; utilisez la correspondance par titre, espace de travail, ID de session ou étiquette pour ces sessionsStockage : 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