explaingit

leepokai/claude-codex-image-gen

Analysis updated 2026-05-18

0ShellAudience · vibe coderComplexity · 2/5LicenseSetup · moderate

TLDR

A Claude Code add-on that generates images through Codex's image tool and creates real transparent cutout PNGs.

Mindmap

mindmap
  root((repo))
    What it does
      Generates images via Codex
      Removes fake backgrounds
      Produces real transparency
    Tech stack
      Bash scripts
      Python for chroma key
      Codex CLI
    Use cases
      App icons
      Product cutouts
      Illustration assets
    Audience
      Claude Code users
      Vibe coders
    Setup
      Codex CLI login
      Optional ImageMagick

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate a transparent app icon from a plain language description.

USE CASE 2

Create product cutout images without a design tool.

USE CASE 3

Fix a broken codex CLI wrapper by forcing a specific binary path.

What is it built with?

ShellPythonCodex CLIImageMagick

How does it compare?

leepokai/claude-codex-image-gen123satyajeet123/bitnet-serveralexbloch-ia/legal-data
Stars000
LanguageShellShellShell
Setup difficultymoderateeasymoderate
Complexity2/52/52/5
Audiencevibe coderdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires the Codex CLI logged in with image generation available.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

This project is a Claude Code skill, meaning it is a small add-on folder that Claude Code can discover and use during a coding session. Its job is to generate image assets by calling on the Codex CLI's built in image_gen tool, then optionally turn the result into a real see-through cutout image. It solves two specific problems that are easy to trip over. First, some installs wrap the codex command in a shim that adds flags an older version of codex does not understand, which causes errors. This skill looks past those wrapper shims and calls a real codex binary directly, and you can also point it at a specific one yourself. Second, when you ask image_gen for a transparent background, it does not actually give you one. It fakes it with a see through looking checkerboard pattern baked into the image. This skill works around that by generating the image on a plain solid color background and then removing that color afterward, which produces a genuine transparent cutout. The process works in four steps: you write a prompt, the image gets generated, the result gets checked, and then, if you want transparency, the background gets removed. To use it, you need the Codex CLI installed and logged in, plus bash and python3. ImageMagick is an optional extra for background removal and checking images across different operating systems. It works on macOS or Linux. Installation means copying the skill folder into the right location, either for every project on your machine or just one project. After that, you can simply describe the image you want in plain language and the skill will activate. There are also two scripts you can call directly if you prefer manual control over generating and removing backgrounds. The project is released under the MIT license.

Copy-paste prompts

Prompt 1
Generate an app icon of a friendly robot waving with a transparent background.
Prompt 2
Use claude-codex-image-gen to create a logo cutout on a green background then remove the background.
Prompt 3
Set CODEX_BIN to my local codex binary and generate a product image.
Prompt 4
Create a flat illustration of a mascot and turn it into a transparent PNG.

Frequently asked questions

What is claude-codex-image-gen?

A Claude Code add-on that generates images through Codex's image tool and creates real transparent cutout PNGs.

What language is claude-codex-image-gen written in?

Mainly Shell. The stack also includes Shell, Python, Codex CLI.

What license does claude-codex-image-gen use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is claude-codex-image-gen to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is claude-codex-image-gen for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.