explaingit

ezbuilder/chatgpt2codex

Analysis updated 2026-05-18

68TypeScriptAudience · developerComplexity · 3/5Setup · moderate

TLDR

A local desktop app that connects ChatGPT to a chosen project folder on your computer, letting it read code, run tests, and capture proof screenshots.

Mindmap

mindmap
  root((ChatGPT To Codex))
    What it does
      Reads and edits local files
      Runs tests and commands
      Captures proof screenshots
    Tech stack
      TypeScript
      MCP protocol
      Local connector server
    Use cases
      Let ChatGPT fix a bug locally
      Run an E2E test with screenshot proof
      Keep source code off the cloud
    Safety
      Loopback only by default
      Owner token approval
      Scoped to chosen folder
    Platforms
      macOS installer
      Windows installer

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

Let ChatGPT read your project's README and run its safest available check, then summarize the result.

USE CASE 2

Have ChatGPT apply a code patch, run your tests, and report back without leaving the chat.

USE CASE 3

Run an end to end test and get screenshot proof that a web or desktop app works.

USE CASE 4

Keep source code entirely local while still letting ChatGPT act on it directly.

What is it built with?

TypeScriptNode.jsMCP

How does it compare?

ezbuilder/chatgpt2codexdikshantbhatia09/shorts-factorymarinedotsh/better-auth-referral
Stars686868
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardeasy
Complexity3/55/52/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 installing a local desktop app and approving a connector token before ChatGPT can access your project.

In plain English

ChatGPT To Codex is a desktop app for macOS and Windows that gives ChatGPT the ability to actually work inside a project folder on your own computer, instead of just talking about code. You install a small local runtime, pick a project folder you trust, and connect it to ChatGPT through a local server. From there ChatGPT can read your files, search your code, apply patches, run your tests, start a local dev server, and even take screenshots of the running app or website to prove that something works. Your source code stays on your machine the whole time. Instead of uploading a copy of your project anywhere, ChatGPT reaches out to the app running locally on your computer, and you decide which folder it can touch and approve a connection token before anything happens. The idea the project describes is simple: ChatGPT thinks, your computer acts, and you review the result. One highlighted workflow is asking ChatGPT to run an end to end test, open the app, capture screenshots of it, and show you the proof directly in the chat. For web apps it can capture parts of a browser window, and for desktop apps built with frameworks like Tauri it can open the built application and capture different views of its window. Setup involves downloading an installer package for your operating system, opening the app from a menu bar or system tray icon, choosing a project folder, starting the local connector, and then registering the resulting connector address inside ChatGPT along with an approval token that the app generates for you. That token should be kept private, similar to a password. The project describes several safety measures: it only listens on your own machine by default, file access is limited to the folder you selected, patches are applied using careful line and content checks, values that look like secrets are hidden from the tool's output, and riskier actions still require your approval. The app's interface supports around twenty languages, and its install guide is currently available in a smaller set of languages including English, Korean, Japanese, and Simplified Chinese.

Copy-paste prompts

Prompt 1
Walk me through installing and connecting this app to ChatGPT on macOS.
Prompt 2
Explain what the Owner Token is for and why I should keep it private.
Prompt 3
Show me how to ask ChatGPT to run my project's E2E tests and show screenshot proof.
Prompt 4
Summarize the safety protections this app puts in place before ChatGPT can touch my files.

Frequently asked questions

What is chatgpt2codex?

A local desktop app that connects ChatGPT to a chosen project folder on your computer, letting it read code, run tests, and capture proof screenshots.

What language is chatgpt2codex written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, MCP.

How hard is chatgpt2codex to set up?

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

Who is chatgpt2codex for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.