aitabby/opencodex

OpenCodex is a local server that runs on your Mac and acts as a bridge between Codex Desktop (an AI coding tool from OpenAI) and third-party AI APIs. By default, Codex Desktop only works with OpenAI's own services. OpenCodex patches the Codex configuration file automatically when it starts up, letting you point Codex at any API that follows the OpenAI format, such as DeepSeek or other providers. The project includes a web dashboard accessible at localhost:8765 in your browser. From there you can add API keys, set custom API endpoints, add or remove models, choose which models appear inside Codex, and restart Codex with one click. A live log stream shows what is happening in real time. There is also a one-click option to restore the original Codex configuration if needed. Two additional components extend what Codex can do on macOS. The first is a Computer Use engine that can control the mouse, keyboard, and windows using the system's native event API, and can take compressed screenshots. The second is a Vision Bridge for AI models that only handle text and cannot process images on their own. When Codex needs to work with a screenshot but the active model does not support images, Vision Bridge compresses the screenshot, sends it to a separate vision-capable model to produce a text description, and injects that description into the prompt instead. This allows text-only models to participate in tasks that would otherwise require image understanding. Installation requires macOS, Node.js version 18 or later, and an existing Codex Desktop installation. Setup is three commands to clone, install dependencies, and start the server. The dashboard opens automatically in the browser.