What is codex-imagegen-free-reference?

Codex ImageGen Free Reference is an add-on for a built-in image generation feature already included in Codex, an AI coding tool. The built-in feature creates or edits images automatically but manages reference images on its own without letting you pick them. This project changes that by giving you direct, explicit control over which local reference image gets used when generating or editing a picture. The tool also fixes a technical mismatch: the standard fallback command line version of Codex's image tool sends requests through the regular OpenAI API, which does not work correctly with certain image models tied to a Codex account login. This project instead routes requests through Codex's own base address, so those account linked models function as expected. Beyond reference image selection, the tool lets you choose which underlying request path is used, either the hosted image generation route or a separate image API route meant for generating and editing, using a command line flag. The built in version only supports one of these paths. You can also choose which specific image model to use and adjust how much reasoning effort it applies, rather than being stuck with whatever defaults Codex currently ships with. When you generate or edit an image, the original files and a log of requests and responses are saved in a folder inside your Codex configuration directory, and the finished images are then copied into your actual project folder, meaning the same image ends up stored in two places. To install it, you clone the project into your Codex skills folder and restart Codex. Once installed, you can trigger it from within Codex with a short natural language command, or you can run the included Python script directly from the command line for the same result.