Skip to content

[codex] organize dotfiles repository layout#10

Merged
gsantovena merged 1 commit into
mainfrom
codex/organize-dotfiles-layout
May 11, 2026
Merged

[codex] organize dotfiles repository layout#10
gsantovena merged 1 commit into
mainfrom
codex/organize-dotfiles-layout

Conversation

@gsantovena

Copy link
Copy Markdown
Owner

Summary

  • Move home-level dotfile sources under home/ while preserving installer targets like ~/.zshrc and ~/.gitconfig.
  • Move XDG config sources under config/ while preserving installer targets under ~/.config/*.
  • Move extended project documentation under docs/, keeping only AGENTS.md and README.md at the repo root.
  • Update installer source roots, tests, CI paths, ignore rules, and documentation for the new layout.
  • Refresh Brewfile from the current Homebrew Bundle dump.

Impact

The repository root is easier to scan, while symlink behavior remains unchanged for installed dotfiles. The installer now maps home/* to ~/.* and config/* to ~/.config/*.

Validation

  • git diff --cached --check
  • make check
  • brew bundle check --file=Brewfile --no-upgrade --verbose

Notes

A pre-existing local Ghostty appearance tweak was intentionally left unstaged and is not part of this PR.

Move home-level sources under home/, XDG config sources under config/, and extended documentation under docs/ so the repository mirrors where the installer links files. Update installer source roots, tests, CI, ignore rules, and documentation to use the new layout while keeping root focused on entrypoint docs and project controls. Refresh Brewfile from the current bundle dump.

Constraint: User requested a cleaner root while preserving existing symlink targets.

Rejected: Add zsh to HOME_FILES | zsh modules are support files for home/zshrc, not a ~/.zsh target.

Rejected: Commit local Ghostty blur tweak | unrelated pre-existing appearance change kept unstaged.

Confidence: high

Scope-risk: moderate

Directive: Keep installer source directories separate from target names; home/ maps to ~/.* and config/ maps to ~/.config/*.

Tested: git diff --cached --check

Tested: make check

Tested: brew bundle check --file=Brewfile --no-upgrade --verbose

Not-tested: Running a real install against the user home directory

Co-authored-by: OmX <omx@oh-my-codex.dev>
@gsantovena gsantovena marked this pull request as ready for review May 11, 2026 17:17
@gsantovena gsantovena merged commit 177132e into main May 11, 2026
5 checks passed
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.

1 participant