codexpro
installs/mo · npmstarsforks
How to install codexpro?
rebel0789/codexpro
$git clone https://github.com/rebel0789/codexproRequirements:
README.md
| 1 | <p align="center"> |
| 2 | <img src="docs/favicon.svg" width="72" height="72" alt="CodexPro logo"> |
| 3 | </p> |
| 4 | |
| 5 | <h1 align="center">CodexPro</h1> |
| 6 | |
| 7 | <p align="center"> |
| 8 | Local coding tools for ChatGPT, scoped to one repo. |
| 9 | </p> |
| 10 | |
| 11 | <p align="center"> |
| 12 | <a href="https://www.npmjs.com/package/codexpro"><img alt="npm" src="https://img.shields.io/npm/v/codexpro?style=flat-square"></a> |
| 13 | <a href="https://github.com/rebel0789/codexpro/actions"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/rebel0789/codexpro/ci.yml?branch=main&style=flat-square"></a> |
| 14 | <a href="https://github.com/rebel0789/codexpro/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/github/license/rebel0789/codexpro?style=flat-square"></a> |
| 15 | <a href="https://rebel0789.github.io/codexpro/"><img alt="Website" src="https://img.shields.io/badge/site-GitHub%20Pages-67e8f9?style=flat-square"></a> |
| 16 | </p> |
| 17 | |
| 18 | ## Install |
| 19 | |
| 20 | Requirements: |
| 21 | |
| 22 | - Node.js 20+ |
| 23 | - A ChatGPT account with Apps / Developer Mode access |
| 24 | - One HTTPS route to your local machine when connecting ChatGPT from the web |
| 25 | |
| 26 | Install the CLI: |
| 27 | |
| 28 | ```bash |
| 29 | npm install -g codexpro |
| 30 | ``` |
| 31 | |
| 32 | Run setup inside the repo you want ChatGPT to work on: |
| 33 | |
| 34 | ```bash |
| 35 | cd /path/to/your/repo |
| 36 | codexpro setup |
| 37 | ``` |
| 38 | |
| 39 | CodexPro prints and copies the Server URL. In ChatGPT, open: |
| 40 | |
| 41 | ```text |
| 42 | Settings -> Security and login -> Developer mode: on |
| 43 | Settings -> Plugins -> Plugins tab -> + (beside Search plugins) |
| 44 | ``` |
| 45 | |
| 46 | This opens **New Plugin**. Give it a name such as `CodexPro`, paste the Server URL in the **Server URL** connection option, then choose `Authentication: No Authentication / None`. The form may initially show OAuth; change it before creating the plugin. CodexPro uses its own URL token. |
| 47 | |
| 48 | ### Current Plugins UI |
| 49 | |
| 50 | | Open Plugins and click `+` | Complete the New Plugin form | |
| 51 | | --- | --- | |
| 52 | |  |  | |
| 53 | |
| 54 | Daily use from the same repo: |
| 55 | |
| 56 | ```bash |
| 57 | codexpro start |
| 58 | ``` |
| 59 | |
| 60 | ## What It Does |
| 61 | |
| 62 | CodexPro starts a local MCP server for the current workspace. ChatGPT can then: |
| 63 | |
| 64 | - read files and inspect the repo |
| 65 | - search code |
| 66 | - make scoped edits with `write`, `edit`, or guarded `apply_patch` |
| 67 | - run safe verification commands through `bash` |
| 68 | - review changed files with `show_changes` |
| 69 | - write handoff plans under `.ai-bridge` |
| 70 | - export a selected context bundle for model surfaces that cannot call tools |
| 71 | |
| 72 | CodexPro is not a hosted service, model proxy, quota bypass, account pool, or OS sandbox. |
| 73 | It connects your own ChatGPT session to your own local repo through the official Developer Mode / MCP app path. |
| 74 | |
| 75 | ## Repository Analysis |
| 76 | |
| 77 | CodexPro builds a bounded repository map from local manifests, source declarations, imports, tests, and Git state. It provides: |
| 78 | |
| 79 | - `inspect_workspace` for languages, project types, entrypoints, areas, symbols, and relationships |
| 80 | - optional structured `search` intents: `text`, `symbol`, `references`, and `impact` |
| 81 | - affected-area, risk, related-test, and focused-command recommendations in `show_changes` |
| 82 | - matching read-only terminal views: |
| 83 | |
| 84 | ```bash |
| 85 | codexpro inspect --root /path/to/repo |
| 86 | codexpro review --root /path/to/repo |
| 87 | codexpro inspect --root /path/to/repo --json |
| 88 | ``` |
| 89 | |
| 90 | The analysis is deterministic and local. It uses confidence labels instead of claiming compiler precision, stays within configured file/byte/symbol limits, and falls back to normal lexical search and Git review when analysis is incomplete. |
| 91 | |
| 92 | Set `CODEXPRO_ANALYSIS=0` to disable repository analysis without changing the rest of the connector. |
| 93 | |
| 94 | ## Normal Commands |
| 95 | |
| 96 | ```bash |
| 97 | codexpro setup |
| 98 | codexpro start |
| 99 | codexpro start --root /path/to/repo |
| 100 | codexpro doctor |
| 101 | codexpro connection-test --root /path/to/repo |
| 102 | codexpro settings |
| 103 | codexpro inspect |
| 104 | codexpro review |
| 105 | ``` |
| 106 | |
| 107 | Useful modes: |
| 108 | |
| 109 | ```bash |
| 110 | codexpro start --no-bash |
| 111 | codexpro start --tool-mode minimal |
| 112 | codexpro start --tool-mode full |
| 113 | codexpro start --mode handoff |
| 114 | codexpro start --mode pro |
| 115 | ``` |
| 116 | |
| 117 | If ChatGPT cannot create |
People who liked this also viewed
6 picksType
- fastapi_mcpExpose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth!MCP ServersNov 2025
- lean-lsp-mcpLean Theorem Prover MCPMCP ServersJul 2026
- rulesyncA Utility CLI for AI Coding AgentsMCP ServersJul 2026
- FunASROpen-source speech recognition toolkit for training, inference, streaming ASR, VAD, punctuation, speaker diarization pipelines, and OpenAI-compatible/MCP serving.MCP ServersJul 2026
- repomix📦 Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Language Models (LLMs) or other AI tools like Claude, ChatGPT, DeepSeek, Perplexity, Gemini, Gemma, Llama, Grok, and more.MCP ServersJul 2026
- mcp-serverMCP server for AI-assisted development of CAP applicationsMCP ServersJul 2026
