gitwtfhub

wtf is codex-supergroklings?

e-simpson/codex-supergroklings — explained in plain English

Analysis updated 2026-05-18

3JavaScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A tool that lets Codex, the AI coding assistant, use Grok 4.5 through your SuperGrok subscription instead of a separate API key.

Mindmap

mindmap
  root((codex supergroklings))
    What it does
      Bridges Grok 4.5 into Codex
      Uses SuperGrok subscription
      Adds Grok as subagent
    Tech stack
      JavaScript
      Bun
      OAuth
    Use cases
      Model choice in Codex
      Code review subagent
      No extra API cost
    Audience
      Codex users
      SuperGrok subscribers

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

Add Grok 4.5 as a selectable model inside the Codex desktop app or CLI.

REASON 2

Let Codex automatically delegate suitable coding tasks to Grok as a subagent.

REASON 3

Ask Grok to review a code change for bugs, security issues, or missing tests.

REASON 4

Use an existing SuperGrok or X Premium+ subscription instead of buying separate xAI API credits.

What's in the stack?

JavaScriptBunNode.jsOAuth

How it stacks up

e-simpson/codex-supergroklingsabhagsain/bayut-maps-ratingsabhishek-kumar09/who-is-imposter
Stars333
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-04-12
MaintenanceDormant
Setup difficultymoderatemoderateeasy
Complexity3/52/53/5
Audiencedevelopergeneralgeneral

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires macOS, Codex Desktop/CLI, Bun or Node.js, and an active SuperGrok or X Premium+ subscription.

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

Wtf does this do

This project lets you use Grok 4.5 inside Codex, the AI coding assistant, by connecting your existing SuperGrok subscription instead of paying separately for an xAI API key. Codex normally only talks to OpenAI models, so this tool adds a bridge that lets Grok 4.5 show up as a selectable model, and even work as a helper agent that Codex can call on for specific tasks. Setup happens through a single command pasted into Codex, which installs a skill that walks you through the process. You will need a Mac, Codex Desktop and the Codex CLI, and either Bun or Node.js. You also need an active SuperGrok subscription or an eligible X Premium+ plan, plus a web browser to approve access, since no separate API key is required. Under the hood, the installer sets up local authentication files, a small local server that only listens on your own machine, and registers Grok 4.5 as a new provider and model option inside Codex. It also applies an optional patch to the Codex desktop app so Grok can be chosen directly as the main model, not just as a helper. This patch is described as careful and reversible, with backups and checks built in, though it does mean the app's update process needs extra manual steps afterward. Once installed, you can either let Codex automatically hand off suitable tasks to Grok, or ask for it explicitly by name when you want a second opinion on a change, such as checking for bugs or missing tests. The project is aimed at existing Codex and SuperGrok subscribers who want more model choice without added API costs. The project is released under the MIT license, so it can be used and modified freely with attribution. It is an independent, unofficial tool and is not affiliated with or supported by OpenAI, Codex, ChatGPT, xAI, or Nous Research.

Yoink these prompts

Prompt 1
Install the setup-codex-grok-supergrok skill globally and run the One-Session Core Install for Grok 4.5.
Prompt 2
Use $grok-subagents to review this change for bugs, security issues, and missing tests.
Prompt 3
Guide me through the browser authorization needed to connect my SuperGrok subscription to Codex.
Prompt 4
Explain what the guarded Desktop patch does and whether I should enable it.

Frequently asked questions

wtf is codex-supergroklings?

A tool that lets Codex, the AI coding assistant, use Grok 4.5 through your SuperGrok subscription instead of a separate API key.

What language is codex-supergroklings written in?

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

What license does codex-supergroklings use?

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

How hard is codex-supergroklings to set up?

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

Who is codex-supergroklings for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

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