[PR #13111] docs(config): clarify OpenCode runtime directory layout #14515

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

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

State: open
Merged: No


What does this PR do?

Fixes #4170.

Adds a dedicated runtime directory section to config docs to clearly separate:

  • ~/.config/opencode (user-managed config)
  • ~/.local/share/opencode (runtime data like auth/session/log/bin)
  • ~/.local/state/opencode (local state)
  • ~/.cache/opencode (rebuildable cache)

Also adds practical backup guidance on what should be preserved vs what can be regenerated.

How did you verify your code works?

  • Confirmed paths and roles against current code usage in Global.Path and related storage/auth/session modules.
  • Validation will run in GitHub Actions CI for docs checks.
**Original Pull Request:** https://github.com/anomalyco/opencode/pull/13111 **State:** open **Merged:** No --- ### What does this PR do? Fixes #4170. Adds a dedicated runtime directory section to config docs to clearly separate: - `~/.config/opencode` (user-managed config) - `~/.local/share/opencode` (runtime data like auth/session/log/bin) - `~/.local/state/opencode` (local state) - `~/.cache/opencode` (rebuildable cache) Also adds practical backup guidance on what should be preserved vs what can be regenerated. ### How did you verify your code works? - Confirmed paths and roles against current code usage in `Global.Path` and related storage/auth/session modules. - Validation will run in GitHub Actions CI for docs checks.
yindo added the pull-request label 2026-02-16 18:19:18 -05:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#14515