Open source · On your Mac · Your images

An image studio for your ChatGPT plan.

Line up your ideas and image-queue works through them with the plan you already pay for. Every image is saved to a folder on your Mac, with its prompt and earlier versions.

Material studies 12
Transparent camera2 versions
Amber glass lamp2 versions
Mechanical toucan2 versions
Gradient sculpture2 versions
Emerald sculpture2 versions
Geometric hummingbird2 versions
Make the glass amber. Keep everything else. Saved to project

Describe it. Make it. Keep it.

1. Describe.

Describe your image and add a reference if you have one. Line up a few ideas at once.

2. Wait.

image-queue works through your ideas while you do something else. See what’s waiting and what’s ready.

3. Keep.

Find every image in its project folder, alongside its prompt. Try another version without losing the first.

Use the plan you already pay for, or your own key.

Your ChatGPT plan

No extra generation charge, within your plan limits. Use a ChatGPT plan that includes Codex. Your existing limits still apply.

Your OpenAI API key

Keep going when your plan limit runs out. Add your own OpenAI API key and choose a model. API generation is billed separately; switching sources is your choice.

A home for every image you make.

Transparent camera above a plinth
Every idea has a next version.
  • A local gallery. Three layouts, projects, tags and search.
  • Versions and references. Iterate on an image without losing the earlier ones.
  • Plain files. Images and prompts live in your own project folders.
  • Private by default. Only the prompt and the references you attach are sent to the provider.

A little help getting started.

Let ChatGPT guide the setup on your Mac. You’ll review and approve the steps along the way.

Set up with ChatGPT

Opens a draft in the desktop app. Choose local Work or Codex, review the prompt, then press Send. You’ll approve the setup steps. Local access depends on your plan and workspace settings.

Read the setup prompt
Set up image-queue on this Mac. Work locally, not in the cloud. If local file access and shell commands are unavailable, stop and explain what I need to enable.

1. Check git, Node.js 24 or newer, pnpm 10.28.2, and the Codex CLI. Tell me what is missing before installing anything. Ask before each tool installation. Do not use sudo without explaining why and receiving my approval.
2. Check https://github.com/corgicorner/image-queue for release v0.1.0. If that release is unavailable, stop and tell me; do not silently install main or a different version.
3. Install that release into ~/image-queue. If the folder already exists, stop and ask me. Do not overwrite it.
4. Run pnpm install --frozen-lockfile, pnpm build and pnpm build:mcp in that folder. Start with pnpm start and verify http://127.0.0.1:3215 responds. If the port is occupied, identify the process and ask me; do not stop it.
5. Run codex login status. If I am not signed in with ChatGPT, explain the step I must complete myself. Never read authentication files, request credentials in chat, or change my existing login. Do not use an API-key login as a substitute for my ChatGPT plan.
6. Offer to create ~/Desktop/image-queue.command after my approval. It should open this existing installation using the detected stable Node and pnpm paths. Do not enable startup at login. Explain that closing the running process stops the queue.
7. Report what was installed, the release version, folder, browser URL, login check and how to start it next time. Clearly list any incomplete step.

Do not change files outside ~/image-queue except approved tool installs and the optional launcher. Do not generate images or connect an API key.
Prefer the terminal?

You’ll need git, Node.js 24+, pnpm 10.28.2 and the Codex CLI for plan-based generation. Tested on macOS (Apple silicon).

Terminal
git clone https://github.com/corgicorner/image-queue.git
cd image-queue
pnpm install --frozen-lockfile
pnpm build
pnpm start

Open http://127.0.0.1:3215, then choose your source in Settings. Keep image-queue running while it works.

FAQ

Do I need an API key?
No, if your ChatGPT plan includes Codex. Sign in with that account during setup. Availability depends on your plan and workspace permissions. An OpenAI API key is an optional, separately billed source.
Is it free?
image-queue is free and open source under Apache 2.0. Generating through your ChatGPT plan uses its existing limits, with no extra generation charge. It does not increase those limits. Using an API key is billed separately.
Where are my images?
In your project folders, as ordinary files. Nothing is uploaded except the prompt and references sent to the provider.
Do I need technical experience?
Setup still installs local tools. ChatGPT can guide you, but you may need to approve installations and sign in yourself. The guided setup has not yet been validated on a clean Mac.

Works with your coding agent too.

Connect an MCP-compatible agent to request images, check progress and retrieve results from the same workspace.

Connect your agent