@getcodexskin/cli
v0.1.2
Published
Safe, reversible macOS theme installer for Codex Skin.
Readme
Codex Skin CLI
The open-source macOS installer and recovery agent for Codex Skin. It applies signed, controlled visual theme packages without modifying the ChatGPT/Codex application bundle or its code signature.
Codex Skin is independent and is not affiliated with or endorsed by OpenAI.
Commands
npx -y @getcodexskin/cli apply theme_example
npx -y @getcodexskin/cli status
npx -y @getcodexskin/cli doctor
npx -y @getcodexskin/cli restore
npx -y @getcodexskin/cli uninstallThe first release supports Apple Silicon and Intel Macs. Themes and state are
stored under ~/Library/Application Support/CodexSkin/. A user LaunchAgent
reapplies the selected theme after normal restarts. Three consecutive structure
or injection failures disable persistence and restart Codex with its official
appearance.
Security model
- Theme packages use Ed25519 signatures and SHA-256 asset hashes.
- Theme JSON is validated against a fixed schema and cannot contain JavaScript.
- Renderer discovery accepts only
app://pages exposed byws://127.0.0.1:<port>. - The app bundle and its signature are never patched.
- The CLI does not read conversations, API keys, project files, or payment data.
restoredisables persistence before restarting Codex normally.
Development
npm test
CODEX_SKIN_API_URL=http://127.0.0.1:3000 node src/cli.mjs doctorSee NOTICE.md for upstream acknowledgements.
