Gestion des sessions

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>

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 la liste des sessions parmi lesquelles choisir.

/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 :

1. Fermez l'autre terminal dans lequel la session est ouverte, puis reprenez-la.
2. Créez une copie distincte de la session en utilisant /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.

• Les sessions ne peuvent être actives que dans un seul processus à la fois (aucun partage multi-fenêtre)
• Les sessions sont stockées par répertoire
• Enregistrement automatique dans la base de données seulement (pas dans des fichiers)
• Les ID de session sont des UUID (non lisibles par un humain)
• Les sessions locales ne se synchronisent pas entre les machines (utilisez des scripts pour un stockage personnalisé); les sessions cloud sont stockées dans le cloud et peuvent être reprises de n'importe où
• Aucune recherche de session par contenu

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 :

• Enregistrement : JSON via stdin, code de sortie 0 en cas de succès
• Chargement : JSON via stdout, code de sortie 0 en cas de succès

• Découvrez les commandes de clavardage
• Consultez le mode de clavardage interactif
• Passez en revue la gestion du contexte
• Utilisez Rewind pour créer une copie d'une conversation à partir d'un tour antérieur