codex-cli-install - SKILL.md Agent Skill

name: codex-cli-install description: A three-part Codex CLI setup skill with subskills for installation, skip-login configuration, and custom API-key launcher setup. Use when the user wants Codex CLI installed or configured on the current host, with instructions adapted to the actual operating system and runtime environment.

Invoke this skill explicitly by name ($codex-cli-install) because it modifies the local host environment.

Detect the host OS first and choose commands accordingly.
On Windows, prefer the PowerShell helpers in scripts/*.ps1; if the user needs a double-clickable entrypoint, use the matching scripts/*.bat wrapper.
On Linux or macOS, prefer the POSIX shell helpers in scripts/*.sh.
Do not mix command styles across OS families.
If the OS is unclear from context, check it before acting.
Treat the scripts in scripts/ as optional accelerators and reference implementations, not the only path.
Before running a helper script, inspect the actual environment: available shell, available package managers, PATH layout, permission constraints, and existing Codex configuration.
If a helper script works in the current environment, use it.
If a helper script fails, do not stop at the script failure. Read the relevant subskill guide under references/, infer the required actions, and execute an environment-appropriate plan manually.

This skill has exactly three subskills.

installation Install the Codex CLI in the current environment. Primary guide: references/installation.md Optional helpers: scripts/install-comp.sh, scripts/install-comp.ps1, scripts/install-comp.bat
skip-login-config Configure Codex to use a custom provider in config.toml with requires_openai_auth = false, so it no longer relies on the built-in login flow. Primary guide: references/skip-login-config.md Optional helpers: scripts/config-skip-login.sh, scripts/config-skip-login.ps1, scripts/config-skip-login.bat
add-custom-api-key Create a custom alias, function, or optional launcher that injects an OpenAI-compatible API key and base URL, and wires Codex to the matching provider configuration. Primary guide: references/add-custom-api-key.md Optional helpers: scripts/config-custom-api-key.sh, scripts/config-custom-api-key.ps1, scripts/config-custom-api-key.bat

If the user wants Codex installed, use installation.
If Codex is already installed but the user wants to bypass the built-in login flow, use skip-login-config.
If the user wants a wrapper such as codex-openai-proxy, a custom base URL, or a custom API key, use add-custom-api-key.
If the user wants a complete setup, run the subskills in this order: installation, then skip-login-config, then add-custom-api-key.

For each subskill:

Read the corresponding file in references/ first.
Detect the OS and shell family.
Check which runtime tools are actually available.
Prefer the documented manual steps from the reference guide.
Use a helper script from scripts/ only if it matches the environment and clearly reduces work.
If the helper script fails, continue by applying the guide manually instead of retrying blindly.
Verify the result with the verification section from the corresponding reference guide.

"Use the Codex CLI install skill to install Codex on this machine."
"Use the skip-login subskill so Codex no longer shows its built-in login flow on this host."
"Use the custom API key subskill to make a codex-openai-proxy alias that reads the key from an environment variable."
"Set up Codex fully, and adapt the steps if the bundled scripts do not work in this environment."