Documentation on sessions #3324

Open
opened 2026-02-16 17:39:39 -05:00 by yindo · 2 comments
Owner

Originally created by @TheCreatorAMA on GitHub (Dec 4, 2025).

Question

Is there documentation on how sessions are created / where they are stored?

Im asking mainly because I may use opencode in a directory that has git initialized but do something there thats not related to the project. However, if I want to reuse that session to follow up on something / see what was said, I have to go back to that directory. It would be nice to have a way to globally manage sessions rather than hopping around directories.

Originally created by @TheCreatorAMA on GitHub (Dec 4, 2025). ### Question Is there documentation on how sessions are created / where they are stored? Im asking mainly because I may use opencode in a directory that has git initialized but do something there thats not related to the project. However, if I want to reuse that session to follow up on something / see what was said, I have to go back to that directory. It would be nice to have a way to globally manage sessions rather than hopping around directories.
Author
Owner

@github-actions[bot] commented on GitHub (Dec 4, 2025):

This issue might be a duplicate of existing issues. Please check:

  • #4048: [FEATURE]: tie working directory / directories with chat session - Requests the ability to tie working directories with sessions to avoid re-navigating
  • #3551: Sessions are now mixed with home directory session list - Related to sessions being isolated by directory
  • #1143: Create session with a different root/working directory - Requests the ability to create sessions with different working directories
  • #4980: Does OpenCode automatically clean up old session/conversation data? - Related to understanding session data storage

These issues discuss related concerns about session management, directory context, and session storage/persistence. Issue #4048 in particular seems closely related to your use case of globally managing sessions without hopping directories.

Feel free to ignore if none of these address your specific case.

@github-actions[bot] commented on GitHub (Dec 4, 2025): This issue might be a duplicate of existing issues. Please check: - #4048: [FEATURE]: tie working directory / directories with chat session - Requests the ability to tie working directories with sessions to avoid re-navigating - #3551: Sessions are now mixed with home directory session list - Related to sessions being isolated by directory - #1143: Create session with a different root/working directory - Requests the ability to create sessions with different working directories - #4980: Does OpenCode automatically clean up old session/conversation data? - Related to understanding session data storage These issues discuss related concerns about session management, directory context, and session storage/persistence. Issue #4048 in particular seems closely related to your use case of globally managing sessions without hopping directories. Feel free to ignore if none of these address your specific case.
Author
Owner

@rekram1-node commented on GitHub (Dec 13, 2025):

This may be helpful?
https://opencode.ai/docs/troubleshooting/#storage

If you have git initialized we only show sessions for that "project"

@rekram1-node commented on GitHub (Dec 13, 2025): This may be helpful? https://opencode.ai/docs/troubleshooting/#storage If you have git initialized we only show sessions for that "project"
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#3324