name: setup-codex-home description: Links repository .codex entries into ~/.codex with symlinks. Use when the user asks to place .codex in the home directory, create symlinks for Codex settings, or sync this repo's .codex into the user directory.
Setup Codex Home
Steps
- Confirm the repository contains the source
.codexdirectory. - Run
bash scripts/setup-codex.shfrom the repository root. - Report the linked entries and any backups created under
~/.codex.
Behavior
- Link each direct child of repository
.codexinto~/.codex, exceptconfig.tomlandskills. - Keep
~/.codexitself as a real directory; do not replace it with a single symlink. - Keep
~/.codex/config.tomlas a home-local config. If it is an old symlink to the repository config, remove that link and restore~/.codex/config.toml.bakwhen present. - If the target already points to the correct source, skip it.
- If a conflicting file, directory, or symlink exists, move it to
${target}.bakbefore linking.
Next Action
Suggest verifying with ls -la ~/.codex.