whatisgithub

What is codex-desktop-custom-models?

ademisler/codex-desktop-custom-models — explained in plain English

Analysis updated 2026-05-18

0JavaScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A starter kit that creates an isolated, separately branded copy of Codex Desktop wired to a different AI model provider like MiniMax.

Mindmap

mindmap
  root((Codex Desktop Custom Models))
    What it does
      Isolated Codex app clone
      Custom icon and home dir
      Provider bridge
    Tech stack
      Node.js scripts
      Electron app bundle
      MiniMax reference provider
    Use cases
      Second AI provider profile
      OpenAI-compatible adapters
      Scheduled automations
    Audience
      Codex Desktop users
      Developers
    Setup
      Shell install scripts
      macOS and Linux
      Needs API key

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

What do people build with it?

USE CASE 1

Run a second Codex Desktop app connected to MiniMax without touching your main Codex install.

USE CASE 2

Adapt the provided bridge to connect Codex Desktop to any OpenAI-compatible model provider.

USE CASE 3

Set up scheduled or same-thread automations for a custom Codex profile.

USE CASE 4

Create multiple isolated Codex apps side by side, each with its own icon and provider.

What is it built with?

JavaScriptNode.jsElectronShellMiniMax

How does it compare?

ademisler/codex-desktop-custom-modelsabhishek-akkal/finovaadan-shahid/ecommerce_website
Stars000
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderateeasymoderate
Complexity3/51/53/5
Audiencedeveloperdeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires an existing Codex Desktop install, Node 18+, and a MiniMax or other provider API key.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Codex Desktop Custom Models is a starter kit for people who use Codex Desktop, a desktop AI coding assistant, and want to run a second, completely separate instance of it that connects to a different AI model provider. Instead of modifying your existing Codex setup, this tool creates a fully isolated clone with its own settings, data directory, icon, and launcher, running alongside the original. The reference implementation included in the kit sets up Codex MiniMax, a second Codex Desktop app with a red icon that connects to the MiniMax M2.7 model through a local bridge. That bridge is the key technical piece. Codex Desktop speaks one API format called the Responses API, but many third party model providers speak a different format called OpenAI-compatible Chat Completions. The bridge translates between these two shapes in real time, including handling tool calls. Setup is done through shell scripts that run on macOS and Linux. On macOS the installer creates a native app bundle and a launch agent, and on Linux it creates a desktop shell profile. Both platforms end up with a separate home directory, for example a folder named .codex-minimax, so the custom profile's sessions, config, and state never mix with the original Codex installation. The kit also includes a local automation server bundled with the custom profile, which supports scheduled background tasks and same thread follow up automations, since custom profiles do not automatically inherit host provided automation tools. The MiniMax profile is just a reference example. The same scripts and bridge can be adapted to any OpenAI-compatible provider by swapping the base URL, model name, and API key. The project is released under the MIT License.

Copy-paste prompts

Prompt 1
Walk me through installing the Codex MiniMax profile on macOS using this repo's scripts.
Prompt 2
Explain how the OpenAI-compatible bridge in this repo translates Codex's Responses API calls.
Prompt 3
Help me adapt this starter kit to a different model provider instead of MiniMax.
Prompt 4
How do I set up and start the local automation runner for a custom Codex profile?
Prompt 5
Show me how to safely remove a custom Codex app created with this kit.

Frequently asked questions

What is codex-desktop-custom-models?

A starter kit that creates an isolated, separately branded copy of Codex Desktop wired to a different AI model provider like MiniMax.

What language is codex-desktop-custom-models written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, Electron.

What license does codex-desktop-custom-models use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is codex-desktop-custom-models to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is codex-desktop-custom-models for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.