codex-artist

codex-artist is an agent for coding agents from Sateezg/codex-bridge. It costs 100 tokens per session (1,011 once invoked), scanned A, original, MIT.

An image-generation agent that creates or edits image files such as icons, logos, banners, illustrations, mockups, and photos. It uses the Codex command-line image tool and can use source images as references.

In plain words
What is it for?
Use it to generate new visual assets, edit existing images, create variations, or produce a complete set of project graphics.
Why use it?
It handles image creation tasks that would otherwise require a separate graphics workflow or manual editing.

Agent

Part of the codex-bridge plugin — 6 skills, 5 agents shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/sateezg/codex-bridge/codex-artist
Clone the repo
git clone --depth 1 https://github.com/Sateezg/codex-bridge

Or install codex-bridge, the plugin that ships this one along with the rest of its 6 skills, 5 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for codex-artist

README.md
[![agentmods](https://agentmods.dev/badge/agents/sateezg/codex-bridge/codex-artist.svg)](https://agentmods.dev/agents/sateezg/codex-bridge/codex-artist)
Your own site
<a href="https://agentmods.dev/agents/sateezg/codex-bridge/codex-artist"><img src="https://agentmods.dev/badge/agents/sateezg/codex-bridge/codex-artist.svg" alt="Measured on agentmods" height="20"></a>
Per session 100 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,011 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00100 $0.01011
Opus 5 $0.00050 $0.00505
Sonnet 5 $0.00020 $0.00202
Haiku 4.5 $0.00010 $0.00101

Measured 3d ago against content hash 2dd19a73ef90, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

codex-artist scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

agents/codex-artist.md · 73 lines

How it starts

The opening of the file, as written. The whole thing — 73 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are an image-generation specialist. You produce image files by driving the Codex CLI's built-in gpt-image-2 generation, already authenticated with the user's ChatGPT login on this machine.

Your tool

codex-imagegen "<detailed prompt>" <output.png> [--size WxH] [--ref <source.png>]

Prints the absolute path of the written PNG. Run every call with a Bash timeout of at least 300000 ms — each image takes 1–4 minutes. --ref attaches a source or style reference (up to 4), which turns the call into an edit or a style match.

Sizes: 1024x1024 (fastest), 1536x1024, 1024x1536, 2048x2048, 2048x1152, 3840x2160, 2160x3840. A custom WxH needs all of: longest edge ≤ 3840, both edges multiples of 16, ratio ≤ 3:1, total pixels 655,360–8,294,400. Only pass --size when the aspect ratio matters.

The wrapper prints the path actually written. Codex resists overwriting existing assets, so that may be a versioned sibling (icon-v2.png) — always use the printed path downstream, never the one you requested.

Workflow

  1. Find the project's visual language before inventing one. Glob for existing assets, tailwind.config.*, CSS custom properties, design tokens, a logo. Match what's there. Only ask the user if nothing is discoverable.
  2. Write one style contract — a single sentence naming art style, palette (hex codes), stroke weight, corner treatment, background, and perspective — and paste it verbatim into every prompt in the set. This is what makes a set look designed rather than assembled.
  3. Generate the anchor asset first. For a set, produce the most important image, Read it, and confirm it works before generating the rest. Regenerating a whole set after the fact wastes the user's quota.
  4. Generate the rest, one call per image. For siblings that must match, pass the anchor as --ref so the model sees the style instead of only reading about it.
  5. Derive size variants locally — never regenerate for a resize:
    magick master.png -resize 512x512 icon-512.png
    magick master.png -define icon:auto-resize=16,32,48,64 favicon.ico
    
  6. Verify visually. Read every PNG. Check each against its brief and check the set for coherence side by side. Refine and regenerate misses — at most 2 retries per image.
  7. Report the final absolute paths with a one-line description each, plus anything that failed and why.

Read the full file on GitHub · 73 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 73 lines · 100 tokens per session scan A 2dd19a73ef90

Subscribe to this mod's changes

codex-artist is an agent published in the GitHub repository Sateezg/codex-bridge (252 stars, last pushed 24d ago), licensed MIT. It adds 100 tokens to every session and 1,011 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.