explaingit

zhishile/codex-auth-helper

Analysis updated 2026-05-18

33CSSAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A Chrome extension that exports your logged-in ChatGPT session token into an auth.json file Codex can use to authenticate.

Mindmap

mindmap
  root((repo))
    What it does
      Reads ChatGPT session
      Exports auth.json
      Shows plan and expiry
    Tech stack
      CSS
      Chrome Manifest V3
    Use cases
      Authenticate Codex locally
      Check session expiry
      Avoid manual token copy
    Audience
      Developers

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

Export your active ChatGPT session token to a file Codex can authenticate with.

USE CASE 2

Check your ChatGPT plan and how long your session token has left before it expires.

USE CASE 3

Avoid manually copying credentials between the browser and Codex config.

USE CASE 4

Inspect the extension's own source to verify it makes no external network calls.

What is it built with?

CSSChrome Manifest V3

How does it compare?

zhishile/codex-auth-helperabrahamhannah/neurodesk-ai-dashboardhamsiny-c/hamsidevintel-pro-
Stars333231
LanguageCSSCSSCSS
Setup difficultyeasyeasymoderate
Complexity2/51/53/5
Audiencedevelopergeneraldeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Must be sideloaded via Chrome developer mode, it is not published on the Chrome Web Store.

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

In plain English

Codex Auth Helper is a Chrome browser extension that exports your active ChatGPT session credentials into a local configuration file that Codex can use for authentication. If you are already logged into ChatGPT in your browser, the extension reads your session token directly from the browser's local state and packages it into the format Codex expects, without sending anything to an external server. When you open the extension popup, it shows your account details: profile avatar, email address, subscription plan (Free, Plus, or Pro), and a live countdown showing how much time remains before the current session token expires. Clicking the export button downloads an auth.json file to your computer using a data URL approach, which avoids leaving temporary files in browser memory. The extension requests only two permissions: downloads (to save the file) and access to chatgpt.com (to read the session data). No third-party libraries are loaded from external CDNs, all code runs locally. The authors note that you can open browser developer tools and inspect popup.js and background.js yourself to verify what the extension does. The extension is built for Chrome using Manifest V3. Installation requires loading it manually through Chrome's developer mode rather than through the Chrome Web Store. The interface uses a glassmorphism visual style with frosted glass elements and animated feedback. The project notes that session tokens are highly sensitive credentials and should never be shared or uploaded anywhere. It is released under MIT license.

Copy-paste prompts

Prompt 1
Help me load this Codex Auth Helper extension in Chrome developer mode.
Prompt 2
Explain how this extension reads my ChatGPT session token without a server.
Prompt 3
Walk me through what permissions this extension requests and why.
Prompt 4
Show me how the exported auth.json file is formatted for Codex.
Prompt 5
Explain the security risks of exporting a session token and how to store it safely.

Frequently asked questions

What is codex-auth-helper?

A Chrome extension that exports your logged-in ChatGPT session token into an auth.json file Codex can use to authenticate.

What language is codex-auth-helper written in?

Mainly CSS. The stack also includes CSS, Chrome Manifest V3.

What license does codex-auth-helper use?

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

How hard is codex-auth-helper to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is codex-auth-helper for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.