Réponse courte : la documentation OpenCode indique un stockage local par projet dans le répertoire de données utilisateur. Sur un environnement Unix, le modèle peut ressembler à ~/.local/share/opencode/project/{project}/storage/session. La route exacte dépend de l’OS et de l’environnement d’exécution.
Réponse courte : le dossier de session est local et lié au projet
La question apparaît souvent lorsqu’un développeur veut retrouver un échange, déplacer l’historique, comprendre l’usage disque ou vérifier si des informations sensibles ont été conservées. Une session OpenCode doit donc être traitée comme une trace privée du projet.
Le chemin indiqué par la documentation officielle sert de repère. Il faut toutefois vérifier l’environnement réel : WSL, conteneur, SSH ou machine distante peuvent stocker les fichiers ailleurs que sur le poste hôte.
Ne mélangez pas historique, configuration et clés de fournisseur. Les sessions conservent du contexte ; la configuration décrit le comportement du projet ; les secrets doivent rester dans un stockage contrôlé.
5 contrôles avant de copier ou supprimer
Revenez d’abord dans le dépôt concerné, identifiez le répertoire de données utilisé par OpenCode, trouvez le dossier projet, vérifiez les dates de modification, puis copiez le dossier complet vers une archive privée.
Si le chemin reste flou, créez une mini-session dans un projet jetable et observez quels fichiers changent. Cette méthode donne une preuve locale sans risquer les données d’un vrai dépôt.
Évitez de copier un seul fichier visible. Les métadonnées voisines peuvent être nécessaires pour relire l’historique correctement.
Quelle tache de session voulez-vous resoudre ?
Historique de session, configuration du projet et connexion provider ne se traitent pas de la meme maniere. Ce tableau aide a choisir entre localiser, copier, restaurer, nettoyer ou partager.
| Situation | Meilleure action | Pourquoi c est important |
|---|---|---|
| Vous cherchez le dossier de sessions | Verifier le runtime et le chemin des donnees projet | OS hote, WSL, conteneurs, SSH et slugs projet peuvent differer |
| Vous cherchez opencode.json | Lire la page de configuration | Configuration et historique de session sont des donnees differentes |
| Vous depannez un provider | Verifier credentials, modele et provider | Le probleme vient souvent de la configuration, pas du stockage |
| Vous migrez vers une autre machine | Ouvrir le projet cible puis restaurer une copie privee | La structure cible reduit les erreurs de chemin et de version |
| Vous voulez partager des fichiers | Preferer un resume ou une reproduction minimale | Les sessions peuvent contenir prompts, chemins, code, sorties terminal et secrets |
Sauvegarder ou déplacer des sessions OpenCode
Fermez OpenCode avant la copie. Archivez le dossier de session hors du dépôt, dans un espace privé ou chiffré. Ne l’ajoutez pas à Git et ne le joignez pas tel quel à un ticket public.
Pour une migration, installez OpenCode sur la nouvelle machine et ouvrez le projet une fois. Les répertoires de base seront créés, puis vous pourrez restaurer une copie et vérifier l’affichage de l’historique.
Dans une équipe, préférez un résumé technique aux fichiers bruts. Il transmet la décision utile sans exposer chemins locaux, code privé ou sortie de terminal.
Confidentialité avant partage ou nettoyage
Une session peut contenir prompts, chemins, sorties de commandes, extraits de code et messages d’erreur. Recherchez les clés API, tokens, domaines internes, identifiants clients et variables d’environnement.
Pour signaler un bug, créez une reproduction minimale dans un dépôt neutre. C’est plus sûr que de masquer manuellement une longue session issue d’un projet réel.
Le nettoyage réduit le risque et l’espace disque, mais il doit être précédé d’une archive privée si l’historique peut servir à l’audit, au support ou à la passation.
Si le dossier attendu est vide
Vérifiez le runtime, le compte utilisateur, le nom de projet et la version. La session a peut-être été créée dans WSL, un conteneur, une session SSH ou une autre machine.
Un déplacement du dépôt peut aussi rompre l’association avec l’ancien dossier. Copiez les candidats, inspectez les timestamps et ne lancez pas de nettoyage tant que vous n’êtes pas certain.
Lorsque l’historique est important, limitez les nouvelles écritures : elles peuvent masquer les indices de modification dont vous avez besoin.
Conclusion : des traces privées de projet
La bonne séquence est simple : localiser, sauvegarder, vérifier, puis nettoyer. Documentez ce processus dans votre guide interne d’usage des assistants de code.
FAQ sur le stockage des sessions OpenCode
Où sont stockées les sessions OpenCode ?
Dans la zone de données locale d’OpenCode, généralement séparées par projet. Vérifiez la route réelle de votre environnement.
Puis-je supprimer d’anciennes sessions ?
Oui, après fermeture d’OpenCode et sauvegarde privée si l’historique peut encore servir.
Faut-il les versionner dans Git ?
Non. Elles peuvent contenir prompts, code, chemins et sorties de commande.
Pourquoi le dossier est-il introuvable ?
Vous cherchez peut-être dans l’hôte alors que la session vient de WSL, SSH, conteneur ou d’un autre compte.
Puis-je les déplacer vers une autre machine ?
Oui avec prudence : créez d’abord les dossiers de base, restaurez une copie et validez avant de supprimer l’archive.
Sources
Use official documentation for current path examples and third-party session readers only as supporting context.