Misleading configuration directories

[ntoxeg]

What is the type of issue?

Documentation is incorrect

What is the issue?

The README mentions ~/.coder as one from which the program reads its configuration but it in fact reads from ~/.code (no r at the end.) It does read from ~/.codex It is unclear whether ~/.coder is used in case VS Code is installed (doesn't seem to be the case) and how is it prioritized (which one takes priority when both are present.)

Where did you find it?

README.md

[just-every-code]

@ntoxeg Thanks for the sharp catch on the config paths! You were absolutely right—~/.coder was incorrect, and the README didn’t clearly explain which directory takes priority.

We’ve updated the docs so they match how the app actually works:

• Your config lives in ~/.code by default.
• If ~/.codex exists (from older setups), Codex uses that instead.
• Auth examples now point to ~/.code/auth.json (legacy ~/.codex/auth.json still works if present).

You can try the preview now:

code preview config-dir-clarify

Once it opens, check the README’s configuration notes—there’s a clear, plain-language explanation of the precedence between ~/.codex and ~/.code.

Does this line up with what you expected? If anything’s still unclear, happy to tweak the wording. Maintainers will review and, once merged, we’ll update you here. Thanks again!