More coding value from ChatGPT

Let ChatGPT code inside your repo.

CodexPro lets ChatGPT web see Codex-style workspace context, inspect files, edit code, and verify changes through MCP. Codex and ChatGPT have separate usage policies, so when Codex is constrained, you can keep coding from ChatGPT if your ChatGPT plan still has capacity.

Start with setup Star on GitHub View npm package

npm install -g codexpro
codexpro setup

codexpro start

OK Local MCP ready at 127.0.0.1:8787

OK Tunnel ready with public HTTPS

OK Server URL copied to clipboard

Next step Paste once. Start coding from ChatGPT. Connection: Server URL. Authentication: None.

Normal coding write=workspace

Read Codex-style context
Edit source files
Run safe verification
Review git status

01 Start

Install once, then run setup inside the folder you want ChatGPT to work on.

02 Paste

The full Server URL is copied automatically, token included.

03 Build

ChatGPT gets agentic tools for the folder on your machine.

Subscription leverage

When Codex is not the right surface, keep moving in ChatGPT.

CodexPro is for builders who already pay for ChatGPT and want that subscription to do more than answer questions. It gives ChatGPT a local workspace bridge: file reads, exact edits, source writes, search, git status, git diff, and allowlisted verification commands.

The hook is practical: Codex and ChatGPT are different product surfaces. If one coding surface is constrained by its own limits, CodexPro gives you another way to keep working against the same local repo.

If your ChatGPT account exposes a stronger model in the web app, including any GPT-5.5-class model available to your account, CodexPro lets that model work against your local repo through MCP. It does not unlock models or bypass limits; it gives your ChatGPT session a practical local coding workflow.

ChatGPT web can see AGENTS.md, .ai-bridge, git state, source files, and selected Codex-style context

Normal coding mode can read, write, edit, search, and verify directly in the workspace

Pro planning mode can export a durable context bundle for sessions where MCP tools are unavailable

Best account fit ChatGPT Plus or Pro with Apps / Developer Mode access. Free and Go accounts do not expose this app flow in current testing.

Quick start

Install once, then run setup in your repo.

The default path uses normal coding mode, workspace writes, safe bash, and a tunnel you choose during setup. After setup, daily startup is just codexpro start.

Install globally

npm install -g codexpro

Run guided setup

codexpro setup

Turn on Developer Mode

In ChatGPT, open Settings -> Apps -> Advanced settings. Turn on Developer mode and keep Enforce CSP in developer mode enabled, then click Create app.

Create a ChatGPT app

Name it CodexPro. Use Connection: Server URL. Paste the copied URL. Set Authentication to No Authentication / None.

Use CodexPro in chat

Ask ChatGPT to inspect files, make scoped edits, and verify with search, read, bash, and git tools.

Tunnel choices

Pick the URL strategy that matches your workflow.

Fastest

Cloudflare quick tunnel

No account flow. Good for demos. The URL changes every restart, so you must update the ChatGPT app Server URL each time.

codexpro start

Recommended

ngrok free dev domain

Best simple stable URL. Create a free ngrok account, use the assigned dev domain, and keep the same ChatGPT app URL across restarts.

codexpro ngrok --hostname your-name.ngrok-free.dev

Custom

Cloudflare named tunnel

Use your own domain, such as codexpro.example.com, and keep one ChatGPT URL.

codexpro stable --hostname codexpro.example.com --tunnel-name codexpro

ngrok setup

Use ngrok's free dev domain for a fixed ChatGPT connector URL.

ngrok free accounts include a dev domain. Find it in the ngrok dashboard under Universal Gateway -> Domains, save it once in CodexPro, and future starts from the same repo are just codexpro start.

That means users do not need to change ChatGPT settings every time they restart CodexPro.

One-time ngrok auth

ngrok config add-authtoken YOUR_NGROK_TOKEN

Save the CodexPro workspace profile

codexpro settings set --tunnel ngrok --hostname your-name.ngrok-free.dev

Daily start

codexpro start

Quick tunnel

codexpro start --tunnel cloudflare

Named tunnel with your domain

cloudflared tunnel login
cloudflared tunnel create codexpro
cloudflared tunnel route dns codexpro codexpro.example.com

Daily stable start

codexpro stable --hostname codexpro.example.com --tunnel-name codexpro

Cloudflare setup

Start instantly with quick tunnels or keep a custom domain with named tunnels.

CodexPro can install cloudflared into ~/.codexpro/bin when it is missing. No sudo, Homebrew, apt, or winget step is required for the default path.

Quick tunnels are disposable. If you own a domain, use a Cloudflare named tunnel and route DNS to a hostname such as codexpro.example.com. The hostname stays the same across restarts, so the ChatGPT app Server URL does not need to change.

Modes

Use the right level of control for the task.

Normal coding

Default. ChatGPT can inspect, write, edit, search, and verify inside the workspace.

Handoff

Planning-only. ChatGPT writes .ai-bridge/current-plan.md and Codex executes locally.

Pro planning

Exports a durable context file for models or surfaces that cannot call MCP tools.

Complete setup data

Everything needed to install, connect, use, and stop CodexPro.

This page keeps the high-signal details in one place: commands, ChatGPT app fields, tunnel choices, tools, saved settings, safety defaults, and useful links.

Install

Install globally once

npm install -g codexpro

This gives users the simple codexpro command everywhere.

First run

Guided setup

codexpro setup

Setup saves the tunnel provider, hostname, port, mode, and token for the current workspace.

Daily start

Reuse saved profile

codexpro start

After setup, future starts from the same repo reuse the saved profile automatically.

ChatGPT settings path

Enable apps once

Open: ChatGPT Settings
Go to: Apps -> Advanced settings
Enable: Developer mode
Keep on: Enforce CSP in developer mode
Then: Create app

This is a one-time ChatGPT setting. CodexPro widgets work with CSP enabled.

Create App fields

Paste the copied URL

Name: CodexPro
Description: Local workspace bridge for ChatGPT coding
Connection: Server URL
Server URL: Paste copied CodexPro URL
Authentication: No Authentication / None

The copied Server URL already includes the private CodexPro token. Do not paste the token separately unless your ChatGPT UI supports custom headers.

Doctor

Preflight checks

codexpro doctor

Checks Node, build output, saved profile, port availability, tunnel prerequisites, clipboard support, and browser-open support.

Settings

Manage saved profiles

codexpro settings
codexpro settings set --tunnel ngrok --hostname your-name.ngrok-free.dev
codexpro settings delete --yes

Use settings to switch providers, reuse another repo setup, or delete a workspace preference.

Controls

Terminal keys

Enter: Open ChatGPT connector settings
c: Copy Server URL again
o: Open local setup/status page
q: Stop CodexPro

Tools ChatGPT gets

Local repo actions exposed through MCP.

server_config open_current_workspace codexpro_inventory codex_context tree search read write edit bash git_status git_diff workspace_snapshot read_handoff export_pro_context handoff_to_codex

Safety defaults

Blocked paths

.env, private keys, .git, node_modules, generated build/cache folders, paths outside the workspace, and symlink escapes are refused.

Safe bash

Verification without full shell

Safe mode allows common repo inspection, git, tests, lint, typecheck, and build commands. Use full bash only for trusted local repos.

Visual widgets

Cards only for useful changes

Write/edit diffs and handoff exports get compact cards. Routine reads, searches, and config calls stay data-only to keep ChatGPT clean.

Stable URL rule

One URL needs one reserved hostname

Cloudflare quick tunnels change on restart. Use an ngrok free dev domain or Cloudflare named tunnel when you want one ChatGPT app URL.

Star the GitHub repo npm package Stable URL guide FAQ Security notes

FAQ

The questions users will ask before installing.

Short answers for account requirements, setup, URLs, safety, and what ChatGPT can actually access.

Which ChatGPT account should I use?

Use ChatGPT Plus or Pro with Apps / Developer Mode access. Current testing shows free and Go accounts do not expose the app flow needed for CodexPro.

Does CodexPro bypass rate limits?

No. It does not unlock models or change OpenAI limits. It gives you another coding surface: if Codex is constrained and ChatGPT still has capacity, you can keep working from ChatGPT.

Why install globally?

Global install gives users one command: codexpro setup. It avoids long npx commands and makes daily startup simply codexpro start.

What URL should I use?

Use Cloudflare quick tunnel for demos. Use an ngrok free dev domain or Cloudflare named tunnel when you want one ChatGPT app URL that survives restarts.

Can ChatGPT see my Codex context?

It can read explicit context files such as AGENTS.md, .ai-bridge, git status/diff, and selected source files. It cannot read hidden Codex runtime memory.

Should CSP stay enabled?

Yes. In Settings -> Apps -> Advanced settings, turn on Developer mode and keep Enforce CSP in developer mode enabled. CodexPro widgets are built for that path.

Start and stop

Keep the terminal running while ChatGPT uses the connector.

CodexPro owns the local MCP server and the tunnel process. Stop it when the session is over.

Start

Run codexpro start in the target repo. The Server URL is copied automatically.

Open

Press Enter in the terminal to open ChatGPT connector settings.

End

Press q or Ctrl+C. Quick tunnel URLs stop working. Stable hostnames stay reserved.

Safety boundary

This is a local developer bridge, not an OS sandbox.

Public tunnels are token-protected by default.
.env, private keys, .git, node_modules, and symlink escapes are blocked.
Safe bash allows common inspection and test commands, not arbitrary shell control.
Use handoff mode when you want ChatGPT to plan and Codex to edit.