How to Install a Codex Theme on macOS (Step by Step)

To install a Codex theme on macOS, use the OpenAI Codex desktop app, confirm Node.js 20 or later, install the open-source GptSkin Skill, and apply a free preset. The preset route needs no GptSkin account and gives you a reversible test before you make a custom theme.

Before You Start

This workflow changes the Codex desktop app appearance. It does not theme Codex CLI, your terminal, or the VS Code extension.

Open Terminal and check Node.js:

node -v

If the major version is below 20, update Node.js before continuing.

Step 1: Let Codex Install the Skill

Open a Codex task and send:

Install this skill and give Codex a new look: https://github.com/WendongAI/gptskin-skill

The repository is public, so you can inspect the scripts before applying anything. Restart Codex after installation.

Step 2: Apply a Free Preset

Ask Codex:

Apply the aurora-borealis preset theme

Or use Terminal:

node ~/.codex/skills/gptskin-theme/scripts/apply-theme.mjs --preset aurora-borealis

All six presets are free and require no account. Browse the best Codex themes or compare the best dark options.

Step 3: Check Real-World Readability

Open a real thread and inspect body text, code, muted labels, selection states, and the composer. A theme that looks attractive in a thumbnail can still fail when controls overlap a bright region, so verify it during normal work.

Step 4: Create a Custom Image Theme (Optional)

Attach an image you own and ask Codex to turn it into a Daily theme. New custom image themes cost 20 Credits; reapplying a saved result is free. See how to create a custom Codex theme for image requirements, authorization, and Daily versus Showcase choices.

Restore the Default Theme

Say:

Restore the default Codex theme

The injected styles and decorative layers are removed. GptSkin does not patch app.asar, replace the Codex binary, alter code signatures, or read conversations.

macOS Troubleshooting

Read how to customize Codex desktop for every available route and security architecture for the technical boundary. GptSkin is independent and is not affiliated with or endorsed by OpenAI.