| name | install-codex-config |
| description | Install or update this organization's Codex configuration from repo-local files into the user's Codex home. Use when asked to set up, install, update, bootstrap, or sync this Codex configuration, including the global AGENTS template, config.toml, hooks, rules, MCP servers, profile templates, and bundled skills. |
Install Codex Config
Contents
- Workflow
- references/workflow.md
Use this skill to install or update the checked-in Codex configuration on the
current machine.
Workflow
- Read
references/workflow.md.
- Use only files from the local repository. Do not fetch configuration from
GitHub or any other network source.
- Discover the source root:
- If the repo contains
codex-config/config.toml and
codex-config/global-agents.md, use codex-config/.
- Otherwise, if the repo root contains
config.toml and
global-agents.md, use the repo root. This is the expected layout after
extracting codex-config/ into its own repository.
- Inventory the target Codex files and ask the user which components to
install or update before writing outside the repository.
- Preview merges for existing
~/.codex/config.toml and ~/.codex/AGENTS.md;
never silently overwrite likely user-customized files.
- Install selected components into Codex paths, then summarize what changed and
any follow-up needed for MCP credentials.
When installing globally, this skill should also install or update itself in
~/.agents/skills/install-codex-config/ so it can be reused from any project.
