Les instantanés vous permettent de sauvegarder tout ce que Crew connaît et fait (mémoire, tâches planifiées, Skills, configuration, paramètres de l'agent) dans un seul fichier portable. Utilisez-les pour passer à une nouvelle machine, récupérer après un problème ou garder deux instances synchronisées.
kirocrew snapshot # → ~/.kiro/crew/snapshots/ kirocrew snapshot ~/my-snapshots --keep 3 # custom dir, prune to 3 kirocrew snapshot --list # list existing snapshots
| Composant | Ce qu'il couvre |
|---|---|
| Mémoire | memory.db, memory_index.db, préférences, projets, historique et bibliothèque de connaissances (workspace/memory/ et workspace/knowledge/) |
| Espace de travail | Arborescences complètes workspace/ et plan_memory/, y compris les sous-arborescences de mémoire lorsqu'elles sont sélectionnées |
| Tâches planifiées | Toutes les tâches planifiées |
| Configuration | Paramètres, mappage de session, hooks, chemins de projet/espace de travail |
| Skills | Définitions de Skills personnalisées |
| Notifications | Historique des notifications du tableau de bord |
| Sécurité | telemetry_salt seulement. La clé de signature d'audit (sel_hmac.key) n'est jamais incluse; elle est régénérée lors de la restauration afin que les HMAC du journal d'audit restent liés à l'hôte qui les a écrits. |
Arrêtez la Gateway avant d'effectuer une restauration. kirocrew restore refuse de s'exécuter lorsqu'une Gateway est à l'écoute, car elle pourrait écraser l'état restauré. Utilisez --force seulement si vous savez que le service à l'écoute sur ce port appartient à une autre instance.
kirocrew stop kirocrew restore snapshot.tar.gz # auto-detect mode kirocrew restore snapshot.tar.gz --components memory,crons # selective kirocrew restore snapshot.tar.gz --dry-run # preview without writing kirocrew restart
Le mode est détecté automatiquement selon la présence de memory.db à destination : une base existante sélectionne Merge; son absence sélectionne Replace. Remplacez ce choix avec --mode replace ou --mode merge.
En mode Replace, Crew déplace l'état qui sera écrasé dans un dossier pre-restore-<timestamp>/ du répertoire de données avant d'appliquer l'instantané. Si la restauration échoue après le début des modifications, Crew tente de rétablir automatiquement l'état précédent. Si cette récupération est incomplète, la commande indique le dossier sauvegardé et les éléments à récupérer manuellement.
Les instantanés locaux ne sont pas automatiques. Planifiez vous-même kirocrew snapshot --keep 7 si vous voulez des sauvegardes locales régulières, puis vérifiez la création des archives avec kirocrew snapshot --list. AWS Control exécute sa propre sauvegarde hors hôte chaque nuit après sa configuration.
# On the source kirocrew snapshot ~/migrate # Copy the tarball to the new machine, then: kirocrew restore ~/migrate/kirocrew-snapshot-*.tar.gz kirocrew doctor
kirocrew snapshot --list kirocrew restore ~/.kiro/crew/snapshots/kirocrew-snapshot-2026-08-15.tar.gz --mode replace
Vous voulez seulement les tâches planifiées d'un instantané, pas la mémoire?
kirocrew restore snapshot.tar.gz --components crons
Pour une sauvegarde continue dans le nuage, utilisez l'application AWS Control. Elle stocke les instantanés dans un compartiment S3 privé, versionné et réservé au propriétaire. Pour en restaurer un, téléchargez l'archive depuis la vue Backup et exécutez kirocrew restore <path> avec le fichier local.
Certains éléments se trouvent en dehors du répertoire de données et ne sont pas inclus :
kiro-cli — connectez-vous séparément sur la machine cible~/.aws/*Pour une migration complète : instantané + kirocrew setup sur la nouvelle machine + réinstallation des applications.
Instantané et restauration