19.2K ·GitHub
What is this?
Codex Auth Helper is a Chrome extension that exports your logged-in ChatGPT session locally and converts it into an auth.json file matching the Codex CLI's expected credential format.
Is this a browser extension or a standalone app?
It is a Chrome browser extension with a popup UI; it is not a standalone desktop or CLI app.
How do I install and use it?
Clone the repo, enable Developer mode in chrome://extensions/, click 'Load unpacked', and select the extension folder containing manifest.json. Then log into ChatGPT, open the extension popup, and click 'generate and save auth.json' to download the file.
Do I need anything besides Chrome and a ChatGPT login?
No external tools are needed — just Chrome in Developer mode and an active logged-in ChatGPT session in that browser.
Does it need to be loaded manually since it's not on the Chrome Web Store?
Yes, it's distributed only as an unpacked extension that you load manually in Developer mode; there's no Chrome Web Store listing mentioned.
What exactly does the auth.json file contain?
It contains a synthetic JWT-style id_token plus account info (avatar, email, subscription plan) assembled to match the format Codex CLI expects for authentication.
What permissions does the extension request?
It only declares the 'downloads' permission to save the generated file, keeping its footprint minimal and auditable.
Can I verify the extension isn't doing anything sneaky?
Yes — all code is unminified and locally bundled with no external CDN dependencies, so you can inspect background.js and popup.js directly via Chrome DevTools.
Does it show how much time is left on my session?
Yes, the popup displays a real-time, second-level countdown of the token's remaining validity period.
What are similar projects?
integrity_baozi-, anti-AD, RemoveMacAI, codelf, JobFlow, JHS-enhance, streamfirefly, ente
Which topics is it in?
privacy-tools, privacy-first, chrome-extension, browser-extension, cli-tool, authentication, css, china, utility, codex, gui, privacy