CodexPro enables ChatGPT to function as a local coding agent for your repository by bridging the ChatGPT web interface with your local development environment. It allows ChatGPT to read, write, edit, and verify code directly within your project, enhancing developer workflows by integrating AI assistance directly into the local codebase.

How It Works

This project acts as a local developer bridge, exposing repository context (files, git status) and safe commands to ChatGPT via its official MCP and Developer Mode app path. It runs a local HTTP MCP server, exposed via a tunnel (Cloudflare, ngrok), allowing ChatGPT to interact with your local setup. CodexPro offers distinct modes for coding, planning, and context export, prioritizing safety with defaults like workspace-only writes and a restricted bash environment.

Quick Start & Requirements

• Install: npm install -g codexpro
• Setup: Run codexpro setup within your target repository.
• Prerequisites: Node.js 20+, ChatGPT Plus/Pro account with Apps/Developer Mode enabled, and a public tunnel option (Cloudflare, ngrok).
• Links: Official website and documentation links are not directly provided in the README text.

Highlighted Details

• Modes: Supports "Normal coding" (direct file interaction), "Handoff" (ChatGPT generates plans for local agents), and "Pro planning" (context export for models without MCP tools).
• Tooling: Exposes file I/O, code search, safe bash execution, git inspection, and skill loading to ChatGPT.
• Safety: Implements workspace-only writes, blocked secret paths, and token-protected URLs.
• UI: Utilizes ChatGPT's Apps SDK for structured, compact tool result cards.
• Context: Provides explicit workspace context through tools like open_current_workspace and codex_context.

Maintenance & Community

The README does not detail specific contributors, sponsorships, or community channels (e.g., Discord, Slack). It is available on GitHub.

Licensing & Compatibility

• License: MIT.
• Compatibility: Permissive for commercial use. Requires a paid ChatGPT account tier (Plus/Pro) and specific developer mode configurations. Some ChatGPT model surfaces may not support MCP tools, necessitating fallback modes.

Limitations & Caveats

Requires a paid ChatGPT account and specific developer settings. Not all ChatGPT models can access MCP tools; "Pro context fallback" is needed for some. CodexPro is a bridge, not an OS sandbox; security relies on user configuration and safe bash modes. Quick tunnels require frequent URL updates in ChatGPT; stable tunnels are recommended for daily use. It does not bypass ChatGPT rate limits or provide model access.