anomalyco/opencode
1
0
Fork 0
mirror of https://github.com/anomalyco/opencode.git synced 2026-07-22 02:05:26 -04:00
Code Issues 5.9k Packages Projects Releases 19 Wiki Activity

docs Data directory documentation is outdated - project/ directory doesn't exist #8197

New Issue
Open
opened 2026-02-16 18:09:24 -05:00 by yindo · 1 comment
yindo commented 2026-02-16 18:09:24 -05:00
Owner
Copy Link
Copy Source

Originally created by @scoful on GitHub (Jan 31, 2026).

Originally assigned to: @jayair on GitHub.

Description

Description
https://opencode.ai/docs/troubleshooting/#storage
The documentation describes the data directory structure as:
%USERPROFILE%\.local\share\opencode
├── auth.json
├── log/
└── project/
├── /storage/ # For Git projects
└── global/storage/ # For non-Git projects
However, the project/ directory does not exist at all. The actual structure is:
%USERPROFILE%\.local\share\opencode
├── auth.json
├── bin/
├── log/
├── snapshot/
│ ├── / # Git projects (identified by hash, not slug)
│ └── global/
├── storage/
│ ├── message/
│ ├── part/
│ ├── project/ # Note: this is storage/project/, not root project/
│ ├── session/
│ └── session_diff/
└── tool-output/
Key Differences

Documentation Actual Implementation
project/ directory at root level Does not exist
project//storage/ snapshot//
Projects identified by slug Projects identified by git commit hash
Environment
  • OS: Windows 11
  • OpenCode version: latest
    Suggestion
    Please update the documentation to reflect the current data directory structure.

Plugins

No response

OpenCode version

No response

Steps to reproduce

No response

Screenshot and/or share link

No response

Operating System

No response

Terminal

No response

Originally created by @scoful on GitHub (Jan 31, 2026). Originally assigned to: @jayair on GitHub. ### Description Description https://opencode.ai/docs/troubleshooting/#storage The documentation describes the data directory structure as: `%USERPROFILE%\.local\share\opencode` ├── auth.json ├── log/ └── project/ ├── <project-slug>/storage/ # For Git projects └── global/storage/ # For non-Git projects However, the project/ directory does not exist at all. The actual structure is: `%USERPROFILE%\.local\share\opencode` ├── auth.json ├── bin/ ├── log/ ├── snapshot/ │ ├── <git-commit-hash>/ # Git projects (identified by hash, not slug) │ └── global/ ├── storage/ │ ├── message/ │ ├── part/ │ ├── project/ # Note: this is storage/project/, not root project/ │ ├── session/ │ └── session_diff/ └── tool-output/ Key Differences | Documentation | Actual Implementation | |--------------|----------------------| | project/ directory at root level | Does not exist | | project/<project-slug>/storage/ | snapshot/<git-hash>/ | | Projects identified by slug | Projects identified by git commit hash | Environment - OS: Windows 11 - OpenCode version: latest Suggestion Please update the documentation to reflect the current data directory structure. ### Plugins _No response_ ### OpenCode version _No response_ ### Steps to reproduce _No response_ ### Screenshot and/or share link _No response_ ### Operating System _No response_ ### Terminal _No response_
yindo added the windowsbugdocs labels 2026-02-16 18:09:24 -05:00
yindo commented 2026-02-16 18:09:24 -05:00
Author
Owner
Copy Link
Copy Source

@github-actions[bot] commented on GitHub (Jan 31, 2026):

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

  • #10592: How does our client access OpenCode CLI context in real-time via Bash? (i.e. Logging API) - discusses the actual data directory structure and storage paths
  • #8538: Session lookup fails with NotFoundError when PTY spawned from non-git directory context - discusses how sessions are stored in snapshot/ and storage/ directories with git commit hashes
  • #10349: Sessions not visible across platforms when syncing data directory (cross-platform session visibility) - discusses the actual session storage structure across platforms

The issue reporter has identified that the documentation at https://opencode.ai/docs/troubleshooting/#storage is outdated and doesn't match the actual implementation. The actual structure uses snapshot/ with git commit hashes and storage/ subdirectories for messages, parts, sessions, etc., whereas the docs describe a project/ directory that doesn't actually exist.

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

@github-actions[bot] commented on GitHub (Jan 31, 2026): This issue might be a duplicate of existing issues. Please check: - #10592: How does our client access OpenCode CLI context in real-time via Bash? (i.e. Logging API) - discusses the actual data directory structure and storage paths - #8538: Session lookup fails with NotFoundError when PTY spawned from non-git directory context - discusses how sessions are stored in snapshot/ and storage/ directories with git commit hashes - #10349: Sessions not visible across platforms when syncing data directory (cross-platform session visibility) - discusses the actual session storage structure across platforms The issue reporter has identified that the documentation at https://opencode.ai/docs/troubleshooting/#storage is outdated and doesn't match the actual implementation. The actual structure uses snapshot/ with git commit hashes and storage/ subdirectories for messages, parts, sessions, etc., whereas the docs describe a project/ directory that doesn't actually exist. Feel free to ignore if none of these address your specific case.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
acp
bad
bug
discussion
docs
documentation
enhancement
extension
good first issue
growth
help-wanted
mcp
model-problem
needs:compliance
nix
opentui
perf
pull-request
Mirrored from GitHub Pull Request
 tui
web
windows
zen
No Label bug docs windows
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
yindo
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#8197
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?