Resposta rápida: a documentação do OpenCode aponta para armazenamento local por projeto dentro do diretório de dados do usuário. Em ambientes Unix, o padrão pode lembrar ~/.local/share/opencode/project/{project}/storage/session. A rota real depende do sistema e do runtime.
Resposta rápida: a pasta de sessão é local e ligada ao projeto
A busca normalmente vem de uma necessidade prática: recuperar histórico, migrar contexto, entender uso de disco ou verificar se dados sensíveis ficaram gravados. Trate sessões como registros privados do projeto.
O caminho oficial é uma referência, mas o local real depende do ambiente. WSL, Docker, SSH, contêineres e servidores remotos podem ter diretórios de dados diferentes do sistema host.
Separe histórico de sessão, configuração do projeto e credenciais do provider. Copiar sessões não substitui uma política correta para chaves e variáveis de ambiente.
5 verificações antes de copiar ou apagar
Volte ao repositório original, identifique o diretório de dados usado pelo OpenCode, encontre a pasta do projeto, confira datas de modificação e só então copie o diretório completo.
Se houver dúvida, crie uma sessão curta em um projeto descartável e veja quais arquivos mudam. Isso revela o padrão local sem tocar em dados reais.
Não copie apenas um JSON visível. Arquivos vizinhos de metadados podem fazer parte da reconstrução do histórico.
Qual tarefa de sessao voce precisa resolver?
Historico de sessao, configuracao do projeto e conexao de provider sao tarefas diferentes. Use a tabela para escolher entre localizar, copiar, restaurar, limpar ou compartilhar arquivos.
| Situacao | Melhor acao | Por que importa |
|---|---|---|
| Voce precisa achar a pasta de sessoes | Verifique runtime e caminho de dados do projeto | Host, WSL, containers, SSH e slugs de projeto podem usar pastas diferentes |
| Voce procura opencode.json | Use o guia de configuracao | Configuracao e historico de sessao sao dados diferentes |
| Voce depura provider | Confira credenciais, modelo e provider primeiro | A falha costuma estar na configuracao, nao no historico |
| Voce quer migrar historico | Abra o projeto destino e restaure uma copia privada | Isso reduz erros de caminho e versao |
| Voce quer compartilhar arquivos | Prefira resumo ou reproducao minima | Sessoes podem conter prompts, caminhos, codigo, terminal e segredos |
Como fazer backup ou mover sessões do OpenCode
Feche o OpenCode antes de copiar. Guarde o diretório de sessão fora do repositório, de preferência em armazenamento privado ou criptografado.
Para migrar, instale OpenCode no destino e abra o projeto uma vez. Depois restaure uma cópia da sessão e valide se o histórico aparece antes de apagar qualquer arquivo antigo.
Em equipes, prefira compartilhar um resumo técnico. Ele preserva a conclusão útil e evita expor caminhos locais, código privado ou saídas de terminal.
Privacidade antes de compartilhar ou limpar
Sessões podem conter prompts, caminhos, comandos, erros, trechos de código e respostas do modelo. Procure chaves API, tokens, domínios internos, IDs de clientes e variáveis de ambiente.
Para reportar bugs, crie uma reprodução mínima em um projeto limpo. Redigir uma sessão real grande é arriscado porque segredos podem aparecer em logs ou stack traces.
Limpar sessões reduz disco e risco de exposição, mas faça uma cópia privada se o histórico ainda pode servir para auditoria, debug ou passagem de contexto.
Quando a pasta esperada está vazia
Revise runtime, usuário, slug do projeto e versão. Talvez a sessão tenha sido criada em WSL, SSH, contêiner ou outra máquina.
Se o repositório mudou de lugar, sessões antigas podem continuar no disco, mas sem associação automática. Copie candidatos e verifique timestamps antes de limpar.
Evite criar muitas sessões novas durante a busca; elas alteram sinais de tempo que ajudam a localizar a pasta correta.
Resumo: sessões são registros privados do projeto
A ordem segura é localizar, copiar, revisar e só então limpar. Documente a regra e mantenha sessões fora do Git.
FAQ sobre armazenamento de sessões do OpenCode
Onde ficam as sessões do OpenCode?
Na área local de dados do OpenCode, normalmente separadas por projeto. Verifique o caminho real do seu ambiente.
Posso apagar sessões antigas?
Sim, mas feche o OpenCode e preserve backup privado se o histórico for importante.
Devo commitar sessões no Git?
Não. Elas podem conter prompts, código, caminhos e saída de terminal.
Por que não encontro a pasta?
Você pode estar olhando no host enquanto a sessão foi criada em WSL, SSH, contêiner ou outro usuário.
Posso mover sessões para outro computador?
Normalmente sim, se criar a estrutura de destino primeiro e validar a restauração.
Sources
Use official documentation for current path examples and third-party session readers only as supporting context.