Open-source MCP bridge for ChatGPT Plus / Pro

ChatGPT plus local repo tools

Use ChatGPT as a local coding agent.

CodexPro connects ChatGPT Developer Mode to the repo on your machine. One setup command gives ChatGPT file reads, code search, exact edits, git status, git diff, safe checks, and Codex-style context. It does not bypass limits or provide models.

AGENTS.md context .ai-bridge handoff stable ngrok or Cloudflare URL

Start with setup Star on GitHub View npm package

npm install -g codexpro
codexpro setup

ChatGPT

“Open the current workspace, read the Codex context, fix the failing test, and show me the diff.”

Developer Mode app: CodexPro

CodexPro tools

codex_context AGENTS.md + .ai-bridge + git state

edit exact replacement inside workspace

bash safe npm test / lint / build

README.md+ Chinese docs link

src/http.tstoken auth checked

.ai-bridge/current-plan.mdhandoff ready

Daily command codexpro start Use ngrok or Cloudflare named tunnel for one stable ChatGPT URL.

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.

Use the account you already have

Give ChatGPT a real local workspace.

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.

Codex and ChatGPT are different product surfaces. If one workflow is unavailable and another surface you already have access to is still available, CodexPro lets you work against the same local repo without changing either product's limits.

If your ChatGPT account exposes a stronger model in the web app, and that model surface can call Developer Mode apps, CodexPro lets it work against your local repo through MCP. Some model surfaces cannot call connectors or MCP tools directly. CodexPro does not provide, proxy, resell, or unlock models; it gives compatible ChatGPT sessions local coding tools and repo context.

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.

Planner to executor

Let ChatGPT plan, then run a local agent on your machine.

Handoff mode keeps ChatGPT planning-only. ChatGPT writes .ai-bridge/current-plan.md, then you decide whether to run a local implementation agent from your terminal.

codexpro execute-handoff runs the saved plan through OpenCode, Pi, Codex, or a custom command, then collects status, stdout/stderr excerpts, and the final git diff back into .ai-bridge for ChatGPT review.

Preview first

codexpro execute-handoff --agent opencode --model provider/model --dry-run

Run locally

codexpro execute-handoff --agent opencode --model provider/model

Custom agent

codexpro execute-handoff --agent custom --command "my-agent --task-file {{plan_file}}"

Result files

.ai-bridge/agent-status.md
.ai-bridge/implementation-diff.patch
.ai-bridge/execution-log.jsonl

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 connectors or MCP tools directly.

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

Default standard tools

Focused local repo actions exposed through MCP.

server_config codexpro_self_test open_current_workspace open_workspace tree search read write edit bash show_changes read_handoff export_pro_context handoff_to_agent

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

Compact cards for every tool

Every CodexPro tool can render a compact v9 card. Skills, git, tree, context, terminal output, and raw diffs stay folded or bounded until opened; load_skill loads bounded instructions on demand.

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.

Local executor

Execution stays on your machine

execute-handoff is a terminal command, not a remote MCP tool. Use --dry-run before running unfamiliar agents or custom commands.

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. A specific model surface may still be unable to call connectors; use Pro context fallback for those sessions.

Does CodexPro bypass rate limits?

No. It does not bypass, avoid, increase, pool, resell, or modify ChatGPT, Codex, OpenAI, or third-party model limits. Every request still runs through your own ChatGPT session and whatever limits that account has.

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.