whatisgithub

What is codex-gpt-plugin?

angieruiz17/codex-gpt-plugin — explained in plain English

Analysis updated 2026-05-18

135JavaScriptAudience · developerComplexity · 4/5Setup · hard

In one sentence

A Codex plugin that lets an AI coding agent send prompts to a logged-in ChatGPT Pro browser session for tougher reasoning tasks.

Mindmap

mindmap
  root((codex-gpt-plugin))
    What it does
      Bridges Codex to ChatGPT Pro
      Browser based calls
      No API key needed
    Features
      Repo scoped rooms
      Repo context upload
      Call receipts and logs
    Tech stack
      JavaScript
      Node.js
      Chrome DevTools Protocol
    Setup
      npm install
      Register as Codex plugin
      Manual login
    Audience
      Codex agent users
      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

Get a second opinion from ChatGPT Pro on architecture decisions while working with a Codex coding agent.

USE CASE 2

Send a summarized version of a repository to ChatGPT Pro for review without sharing API keys or passwords.

USE CASE 3

Keep separate ongoing ChatGPT conversation threads per repository for different kinds of work, such as debugging or critique.

What is it built with?

JavaScriptNode.jsChrome DevTools Protocol

How does it compare?

angieruiz17/codex-gpt-pluginmatchameleon/moneyclawangieruiz17/claude-fintech-skills
Stars135135134
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyhardmoderateeasy
Complexity4/53/52/5
Audiencedeveloperdeveloperdeveloper

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

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires a logged-in ChatGPT Pro account, a dedicated Chrome profile, and manual login completion before first use.

So what is it?

This repository is a plugin for Codex, the coding agent, that lets it place a call to a logged-in ChatGPT Pro session in a real browser window. The idea is that Codex is strong at doing the actual coding work, but for harder problems like architecture decisions, research, weighing tradeoffs, or tricky debugging strategy, it can be useful to bring in a second opinion. Instead of using an API key or handling passwords, the plugin drives an actual browser where a human is already logged in, attaches the current repository as context, sends a message, reads back the reply, and saves a record of the exchange. Conversations are organized into named rooms tied to a specific git repository, such as main, debug, critic, or scratch, so different projects and different lines of work stay separated. When useful, the plugin can also build a single file containing a summary of the repository's source code, checking first for anything that looks like a secret before it is shared, and only sending it after the user confirms. A dedicated Chrome browser profile stays signed in between calls, and a locking system makes sure that if multiple Codex agents try to use the plugin at the same time, they take turns instead of interfering with each other's browser session. Every call is logged with the exact prompt and response, a screenshot, and technical logs, so there is a clear record of what was asked and answered. Installing it involves running npm install inside a local copy of the repository, then registering it with Codex as a plugin. From there, a command line tool called chatgpt-pro handles logging in, sending prompts, checking status, and managing the different conversation rooms. The project emphasizes that automation never types passwords or solves login challenges on the user's behalf, and it only interacts with the page through text input, never through simulated mouse or keyboard control. No license file is mentioned in the README shown.

Copy-paste prompts

Prompt 1
Walk me through installing this Codex plugin and connecting it to my logged-in ChatGPT Pro account.
Prompt 2
Use this plugin to send my repository's architecture to ChatGPT Pro and ask it to name the biggest risk.
Prompt 3
Explain how the room system in this plugin keeps different projects' conversations separate.
Prompt 4
Show me how to export the visible chat history from one of this plugin's rooms.

Frequently asked questions

What is codex-gpt-plugin?

A Codex plugin that lets an AI coding agent send prompts to a logged-in ChatGPT Pro browser session for tougher reasoning tasks.

What language is codex-gpt-plugin written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, Chrome DevTools Protocol.

How hard is codex-gpt-plugin to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is codex-gpt-plugin for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.