[PR #11587] docs: update outdated storage directory structure (#11560) #13850

Open
opened 2026-02-16 18:18:41 -05:00 by yindo · 0 comments
Owner

Original Pull Request: https://github.com/anomalyco/opencode/pull/11587

State: open
Merged: No


Summary

Fixed outdated storage directory structure documentation in the troubleshooting guide.

Changes Made

Updated packages/web/src/content/docs/troubleshooting.mdx to reflect the current data directory structure:

  • Removed outdated structure:

    • project/ directory at root level
    • Projects identified by slug
    • project//storage/ path
  • Added current structure:

    • bin/ - Binary executables
    • snapshot/ - Project snapshots (identified by git commit hash, not slug)
    • storage/ - Session and message data with subdirectories:
      • message/ - Message history
      • part/ - Part data
      • project/ - Project-specific data
      • session/ - Session data
      • session_diff/ - Session differences
    • tool-output/ - Tool execution outputs

Issue

Resolves #11560 - Documentation was outdated and didn't match the actual implementation.

Testing

  • Documentation builds successfully
  • Changes are consistent with actual file structure
  • No breaking changes to existing functionality
**Original Pull Request:** https://github.com/anomalyco/opencode/pull/11587 **State:** open **Merged:** No --- ## Summary Fixed outdated storage directory structure documentation in the troubleshooting guide. ## Changes Made Updated `packages/web/src/content/docs/troubleshooting.mdx` to reflect the current data directory structure: - **Removed outdated structure**: - `project/` directory at root level - Projects identified by slug - `project//storage/` path - **Added current structure**: - `bin/` - Binary executables - `snapshot/` - Project snapshots (identified by git commit hash, not slug) - `storage/` - Session and message data with subdirectories: - `message/` - Message history - `part/` - Part data - `project/` - Project-specific data - `session/` - Session data - `session_diff/` - Session differences - `tool-output/` - Tool execution outputs ## Issue Resolves #11560 - Documentation was outdated and didn't match the actual implementation. ## Testing - Documentation builds successfully - Changes are consistent with actual file structure - No breaking changes to existing functionality
yindo added the pull-request label 2026-02-16 18:18:41 -05:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#13850