Risposta breve: OpenCode documenta dati di sessione locali e specifici del progetto nel percorso dati dell’utente. In ambienti Unix può apparire come ~/.local/share/opencode/project/{project}/storage/session, ma la posizione precisa dipende dal sistema e dal runtime.
Risposta breve: la cartella sessione è locale e per progetto
Chi cerca il percorso vuole spesso recuperare cronologia, migrare contesto, capire lo spazio disco o verificare dati sensibili. Le sessioni OpenCode vanno quindi trattate come registri privati del progetto.
Il percorso ufficiale è un punto di partenza. WSL, Docker, SSH, container e macchine remote possono usare directory dati diverse da quella del sistema host.
Distingui cronologia, configurazione e credenziali. Spostare sessioni non significa spostare provider, chiavi API o impostazioni sicure.
5 controlli prima di copiare o cancellare
Torna nel repository originale, trova la directory dati di OpenCode, identifica la cartella del progetto, controlla le date di modifica e copia solo dopo l’intera cartella sessione.
Se il percorso è incerto, crea una mini-sessione in un progetto usa e getta e osserva quali file cambiano. È una prova sicura e locale.
Non copiare un solo JSON visibile. Metadati e file adiacenti possono essere necessari per ricostruire correttamente la cronologia.
Quale attivita sulle sessioni devi risolvere?
Cronologia di sessione, configurazione del progetto e connessioni provider richiedono controlli diversi. Usa la tabella per scegliere tra trovare, copiare, ripristinare, pulire o condividere file.
| Situazione | Azione migliore | Perche conta |
|---|---|---|
| Devi trovare la cartella sessioni | Verifica runtime e percorso dati del progetto | Host, WSL, container, SSH e slug del progetto possono usare cartelle diverse |
| Cerchi opencode.json | Usa la guida di configurazione | Configurazione e cronologia non sono lo stesso dato |
| Hai un problema provider | Controlla credenziali, modello e provider | La connessione dipende spesso dalla configurazione, non dalle sessioni |
| Vuoi spostare la cronologia | Apri prima il progetto di destinazione e ripristina una copia privata | Riduce errori di percorso e versione |
| Vuoi condividere file | Preferisci un riepilogo o una riproduzione minima | Le sessioni possono includere prompt, percorsi, codice, output terminale e segreti |
Backup e migrazione delle sessioni OpenCode
Chiudi OpenCode prima della copia. Salva la cartella fuori dal repository, idealmente in uno spazio privato o cifrato.
Per migrare, installa OpenCode sulla nuova macchina e apri una volta il progetto. Poi ripristina una copia e verifica il risultato prima di eliminare l’archivio.
In un team, invia un riepilogo tecnico invece dei file grezzi quando possibile. Riduce il rischio di esporre codice, percorsi e output di terminale.
Privacy prima di condividere o pulire
Una sessione può contenere prompt, percorsi, comandi, errori, frammenti di codice e risposte del modello. Cerca API key, token, domini interni, ID cliente e variabili d’ambiente.
Per segnalare un bug, crea una riproduzione minima in un repository pulito. Redigere a mano una sessione reale è più rischioso.
La pulizia è utile, ma prima archivia se la cronologia può servire per audit, debug o passaggio di consegne.
Quando la cartella prevista è vuota
Controlla runtime, utente, slug del progetto e versione. La sessione potrebbe essere stata creata in WSL, SSH, container o su una macchina remota.
Se il repository è stato spostato, la sessione vecchia può esistere ma non essere più associata. Copia i candidati e analizza timestamp e struttura.
Evita nuove scritture non necessarie durante la ricerca, perché alterano gli indizi temporali.
Sintesi: sessioni come registri privati
La sequenza corretta è trovare, salvare, verificare e poi pulire. Tieni questi file fuori da Git e documenta la procedura.
FAQ sullo storage delle sessioni OpenCode
Dove sono salvate le sessioni OpenCode?
Nell’area dati locale di OpenCode, di solito separate per progetto. Verifica il percorso reale del tuo ambiente.
Posso eliminare sessioni vecchie?
Sì, ma chiudi OpenCode e conserva una copia privata se la cronologia può servire.
Devo committarle in Git?
No. Possono contenere prompt, codice, percorsi e output del terminale.
Perché non trovo la cartella?
Forse la sessione è stata creata in WSL, SSH, container o con un altro utente.
Posso spostarle su un’altra macchina?
Sì con cautela: crea prima la struttura di destinazione e verifica il ripristino.
Sources
Use official documentation for current path examples and third-party session readers only as supporting context.