gitwtfhub

wtf is codex-nn?

slovx2/codex-nn — explained in plain English

Analysis updated 2026-05-18

23RustAudience · vibe coderLicense

TL;DR

Codex NN is an unofficial desktop app that lets you visually browse, apply, and even AI generate custom themes for the official Codex Desktop client on macOS and Windows.

Mindmap

mindmap
  root((Codex NN))
    What it does
      Visual theme manager
      One click switching
      AI theme design
    Tech stack
      Rust
      Tauri
      TypeScript
    Use cases
      Codex customization
      Theme pack import
      Restore official look
    Audience
      Codex Desktop users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Switch the visual theme of your Codex Desktop app with one click instead of editing files by hand.

REASON 2

Import theme packs originally made for the Codex Dream Skin project.

REASON 3

Describe a visual style in plain language and have an AI assisted plugin generate a matching theme package.

REASON 4

Restore Codex Desktop to its official appearance at any time if a theme causes problems.

What's in the stack?

RustTauriTypeScript

How it stacks up

slovx2/codex-nnadindazu/tangoaudiobigmacfive/turbo-graph
Stars232323
LanguageRustRustRust
Setup difficultymoderatemoderate
Complexity3/54/5
Audiencevibe coderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

Wtf does this do

Codex NN is a desktop app that lets you change the visual theme of Codex Desktop, the official desktop client for OpenAI's Codex. The project is unofficial and community made. It does not modify the official Codex installer, program files, or code signing, and it is not affiliated with OpenAI or Anthropic. Instead of manually editing files or running scripts to change how Codex looks, you open Codex NN, pick a theme from its library, and apply it with one click. The app ships with five built in themes covering different visual styles, and it can also import theme packs made for a related project called Codex Dream Skin. A minimal theme pack is just two files: a theme.json declaration and a background image, with no scripts, CSS, remote resources, or encrypted files allowed, which keeps themes simple and predictable. Beyond picking pre made themes, Codex NN includes an AI assisted theme design feature. You describe the visual style you want, or provide a reference image, and it can install a companion design plugin for either Codex or Claude Code. That plugin generates a full interface concept for you to approve, then produces the background, colors, and text for a new theme package, installing and previewing it live through a local connection so you can keep giving feedback until you are happy with the result. Under the hood, Codex NN works by connecting only to a local Chrome DevTools Protocol port on your own machine to apply themes to the running Codex window, with a background process keeping the theme active. It does not replace official binaries or break code signing, and a full restore option returns Codex to its official appearance at any time. The app supports macOS and Windows, with Linux not yet supported. Codex NN is open source under the MIT license.

Yoink these prompts

Prompt 1
Design a Codex Desktop theme with a dark blue and neon accent color scheme using the Codex NN theme designer plugin.
Prompt 2
Walk me through installing a Codex Dream Skin theme pack into Codex NN.
Prompt 3
Explain how Codex NN applies themes without modifying the official Codex installation.
Prompt 4
Show me how to build a minimal Codex NN theme package with a theme.json file and a background image.

Frequently asked questions

wtf is codex-nn?

Codex NN is an unofficial desktop app that lets you visually browse, apply, and even AI generate custom themes for the official Codex Desktop client on macOS and Windows.

What language is codex-nn written in?

Mainly Rust. The stack also includes Rust, Tauri, TypeScript.

Who is codex-nn for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.