Codex Skin Command Cheat Sheet

This is the Codex Skin Command Cheat Sheet, detailing the various ways to manage Codex skins. There are three main locations for these commands: the Command Line Interface (CLI), the Codepilot Terminal UI (TUI), and a separate Go tool. The cheat sheet presents all these commands in one table for easy reference.

To install a Codex skin, use the provided bash script once per machine: `bash curl -fsSL https://raw.githubusercontent.com/vufly/bearded-theme-ports/master/scripts/install-codex.sh | sh`. To view installed skins, open the Codex CLI and run `/theme`. If the list is empty, run the installation script, close the prompt, and open it again.

Codex CLI adds a preview feature before committing changes, allowing you to test themes like "Tokyo Night CLI" against a light terminal without permanently applying them. Switching skins from the terminal is straightforward: simply name the theme, and it applies immediately.

Keep in mind that some ports cache colors at startup, so if the palette appears incorrect after applying a theme, restart the Codex CLI. To revert to a previous theme when comparing candidates, use the `codex-theme rollback` command, which is faster than reapplying the previous theme manually.

Useful shortcuts include name matching, which is forgiving in the CLI prompt, and using arrow keys and Enter for shorter lists. Previewing before applying with `codex-theme preview` saves a restart each time. To ensure consistency across terminals, export the palette using `codex-theme export`.

If a command appears to do nothing, it simply means no port is installed yet. To address this, run the installation script again and reopen the prompt. If the palette still looks wrong after applying a theme, restart the Codex CLI as ports cache colors at startup.

Note that the `/skin` command is not recognized in the stock Codex CLI; it exists only in the Codepilot TUI. Desktop environments use a different installation method, so consult the installation guide for both paths. When multiple themes share the same name, apply them by slug using `codex-theme apply` instead of the display name for unambiguous results.

Remember that changes may be lost after a Codex update, as it resets the theme directory. To prevent this, keep the installation script in your dotfiles for easy restoration. Outside of Codex, the terminal may still appear different; however, running `codex-theme export` ensures the surrounding prompt, selection highlight, and background follow the same palette.

To maintain consistency, keep a note of the exact command that produced the desired look. This will make it easier to recreate the setup on future machines. For more detailed information, refer to the companion read "Codex skin file formats explained" and the skin index, which lists all currently available skins.