Skip to content

docs: clarify XDG config location - #6670

Closed
pwuersch wants to merge 2 commits into
anomalyco:devfrom
pwuersch:docs/correct-global-config-file-location
Closed

pwuersch wants to merge 2 commits into
anomalyco:devfrom
pwuersch:docs/correct-global-config-file-location

Conversation

@pwuersch

@pwuersch pwuersch commented Jan 2, 2026 •

Copy link
Copy Markdown

Fixes #6669

Extends the "Global" section in the "Config" page to correctly OpenCodes preference of the XDG base directories when set.

Adjusts other locations where the global configuration is incompletely assumed to be only in ~/.config/opencode with backlinks to the "Config" page or small notes that the actual behavior is more complex.

@pwuersch
pwuersch force-pushed the docs/correct-global-config-file-location branch from 0de285b to 574c0f3 Compare January 7, 2026 09:48
@pwuersch
pwuersch marked this pull request as ready for review January 7, 2026 09:49
Updated Global config section to document XDG_CONFIG_HOME support.
Config is loaded from $XDG_CONFIG_HOME/opencode/opencode.json when set,
falling back to ~/.config/opencode/opencode.json by default.
Updated references to global config files to link to the detailed
config locations documentation instead of duplicating XDG_CONFIG_HOME
information across multiple pages.
@github-actions

Copy link
Copy Markdown
Contributor

Closing this pull request because it has had no updates for more than 60 days. If you plan to continue working on it, feel free to reopen or open a new PR.

@github-actions github-actions Bot closed this Mar 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs miss mentioning XDG base directories for global configuration while already supporting them

1 participant