Kurzantwort: OpenCode verweist auf lokale projektbezogene Session-Daten im Benutzer-Datenverzeichnis. In Unix-ähnlichen Umgebungen kann der Pfad etwa ~/.local/share/opencode/project/{project}/storage/session lauten. Prüfe immer den tatsächlichen Pfad deiner Laufzeitumgebung.
Kurzantwort: Sessions liegen lokal und projektbezogen
Wer nach dem Speicherort sucht, möchte meist Verlauf wiederfinden, auf einen anderen Rechner übertragen, Speicherplatz prüfen oder sensible Inhalte kontrollieren. Behandle OpenCode Sessions deshalb wie private Projektaufzeichnungen.
Der offizielle Pfad ist ein zuverlässiger Startpunkt, aber nicht jede Umgebung sieht gleich aus. WSL, Docker, SSH und Dev-Container können ihre eigenen Datenverzeichnisse haben.
Unterscheide Session-Verlauf, Projektkonfiguration und Provider-Zugangsdaten. Ein Session-Backup ersetzt keine saubere Konfigurations- oder Secret-Strategie.
5 Pfadprüfungen vor Kopie oder Löschung
Öffne zuerst das Repository, in dem die Session entstanden ist. Ermittle dann das OpenCode-Datenverzeichnis, suche den projektbezogenen Ordner, prüfe Änderungszeiten und kopiere erst danach den vollständigen Session-Ordner.
Wenn du unsicher bist, erstelle in einem Testprojekt eine kurze neue Session und beobachte, welche Dateien sich ändern. Das ist sicherer als direkt im Produktionsprojekt zu experimentieren.
Kopiere nicht nur eine sichtbare JSON-Datei. Benachbarte Metadaten können für die Wiederherstellung des Verlaufs wichtig sein.
Welche Session-Aufgabe willst du loesen?
Session-Verlauf, Projektkonfiguration und Provider-Verbindung sind verschiedene Aufgaben. Nutze die Tabelle, um zwischen Suchen, Kopieren, Wiederherstellen, Bereinigen und Teilen zu unterscheiden.
| Situation | Beste Aktion | Warum das wichtig ist |
|---|---|---|
| Du suchst den Session-Ordner | Runtime und Projektdatenpfad pruefen | Host-OS, WSL, Container, SSH-Hosts und Projekt-Slugs koennen unterschiedliche Ordner nutzen |
| Du suchst opencode.json | Konfigurationsanleitung statt Session-Verlauf nutzen | Projektkonfiguration und Chatverlauf sind unterschiedliche Daten |
| Du pruefst eine Provider-Verbindung | Credentials, Modell und Provider-Einstellungen zuerst pruefen | Verbindungsfehler liegen meist nicht am Session-Speicher |
| Du migrierst auf einen anderen Rechner | Zielprojekt einmal oeffnen, dann private Kopie wiederherstellen | Die Zielstruktur reduziert Pfad- und Versionskonflikte |
| Du willst Session-Dateien teilen | Zusammenfassung oder Minimalreproduktion bevorzugen | Rohdaten koennen Prompts, Pfade, Code, Terminalausgaben und Secrets enthalten |
OpenCode Sessions sicher sichern oder verschieben
Schließe OpenCode vor dem Kopieren, damit keine Datei halb geschrieben wird. Lege das Backup außerhalb des Git-Repositories ab, idealerweise privat oder verschlüsselt.
Für eine Migration installierst du OpenCode auf dem Zielsystem und öffnest das Projekt einmal. Danach stellst du eine Kopie des Projekt-Session-Ordners wieder her und validierst den Verlauf.
Für Teamkommunikation ist eine technische Zusammenfassung meist besser als rohe Session-Dateien. Sie reduziert das Risiko, interne Pfade, Code oder Terminalausgaben offenzulegen.
Datenschutzprüfung vor Teilen oder Bereinigung
Sessions können Prompts, lokale Pfade, Kommandos, Fehler, Codeausschnitte und Modellantworten enthalten. Suche vor dem Teilen nach API Keys, Tokens, internen Domains, Kundendaten und Umgebungsvariablen.
Für Bugreports ist ein minimales Reproduktionsprojekt besser als eine geschwärzte echte Session. Geheimnisse verstecken sich oft in Konsolenausgaben oder Stacktraces.
Bereinigung ist sinnvoll, wenn du Speicherplatz reduzieren oder Spuren entfernen willst. Sichere vorher, falls der Verlauf für Audit, Übergabe oder Debugging relevant sein könnte.
Wenn der erwartete Ordner leer ist
Prüfe Runtime, Benutzerkonto, Projekt-Slug und Version. Die Session könnte in WSL, SSH, einem Container oder auf einer Remote-Maschine erstellt worden sein.
Nach einem Verschieben des Repositories kann der alte Ordner noch existieren, aber nicht mehr automatisch erkannt werden. Kopiere Kandidaten und prüfe Zeitstempel, bevor du etwas löschst.
Erzeuge während der Suche nicht unnötig viele neue Sessions, weil sie Änderungszeiten überschreiben und die Spurensuche erschweren.
Fazit: Sessions sind private Projektdaten
Die sichere Reihenfolge lautet: finden, sichern, prüfen, löschen. Dokumentiere diese Regel in deinem internen Leitfaden für AI-Coding-Tools.
FAQ zum OpenCode Session-Speicher
Wo speichert OpenCode Sessions?
Im lokalen OpenCode-Datenbereich, meist getrennt nach Projekt. Prüfe den tatsächlichen Pfad deiner Umgebung.
Kann ich alte Sessions löschen?
Ja, aber schließe OpenCode und sichere wichtige Verläufe vorher privat.
Soll ich Session-Dateien in Git committen?
Nein. Sie können Prompts, Code, Pfade und Terminalausgaben enthalten.
Warum finde ich den Ordner nicht?
Möglicherweise lief OpenCode in WSL, SSH, einem Container oder unter einem anderen Benutzer.
Kann ich Sessions verschieben?
Meist ja, wenn du erst die Zielstruktur erzeugst, eine Kopie wiederherstellst und die Anzeige prüfst.
Sources
Use official documentation for current path examples and third-party session readers only as supporting context.