codex-image-in-cc
🇰🇷 한국어 자세한 사용 가이드: GUIDE.md
Fork notice. This is a fork of KingGyuSuh/codex-image-in-cc (Apache-2.0). The original three commands (status, generate, edit) are preserved; this fork adds four production-asset commands — style-gen, asset-pipeline, slice, organize — plus an end-to-end atlas pipeline (strict containment, verify-atlas, kind-first organize layout, transparent-output via magenta chroma key, per-kind convention blocks for sprite / UI / VFX / font / tileset). See NOTICE for attribution and CHANGELOG.md for the full evolution.
Claude Code plugin that exposes Codex CLI's built-in imagegen skill as /codex-image:* user-invoked plugin skills, with extra orchestration for shipping-quality game / app asset batches.
The plugin does not implement image generation itself. Each generation skill dispatches to codex exec --full-auto and lets Codex's imagegen skill drive the built-in image_gen tool, save the final artifact, and print a SAVED: <path> line for each output. slice, organize, and the verify-atlas dispatcher subcommand are Pillow / stdlib-backed Python helpers shelled out via the same Node dispatcher.
Requirements
- Claude Code with plugin support.
@openai/codex CLI v0.124.0 or later.- An active
codex login session.
- Node.js 18.18 or later.
- Python 3 + Pillow — only needed for
slice, organize, and verify-atlas. The image-generation commands do not require Python.
OPENAI_API_KEY is not required for the default built-in path. Codex can use either a ChatGPT login or API-key login.
Install
From GitHub
claude plugin marketplace add gmlxo76/codex-image-in-cc
claude plugin install codex-image@codex-image-in-cc
From a local clone
git clone https://github.com/gmlxo76/codex-image-in-cc.git
cd codex-image-in-cc
claude plugin marketplace add "$PWD"
claude plugin install codex-image@codex-image-in-cc
Then restart Claude Code if needed. Default install scope is user; pass --scope project or --scope local to limit installation.
Plugin Skills
Seven user-invoked slash commands:
| Command | Purpose |
|---|
/codex-image:status | Node / Codex CLI / login / imagegen skill availability check |
/codex-image:generate | New image from text prompt only |
/codex-image:edit | Modify an existing image (input attached via codex exec --image) |
/codex-image:style-gen | New image whose visual style matches an attached reference (reference itself is never modified or saved) |
/codex-image:asset-pipeline | Interactive batch — plan asset list from project context, confirm, generate each via style-gen, verify atlases |
/codex-image:slice | Slice an atlas sheet into per-cell PNGs + atlas.json sidecar; supports single-sheet and manifest modes |
/codex-image:organize | Reorganize an asset-pipeline manifest into a kind-first engine folder layout |
Usage examples
/codex-image:status
# Generate from text prompt only
/codex-image:generate "A watercolor moonlit library, save to images/library.png at 1024x1024"
/codex-image:generate "5 logo variations of a brass compass on white, save under images/logos/"
# Edit an existing image
/codex-image:edit input.png "Replace the background with a clean white studio backdrop, save to edited.png"
# Generate a NEW image whose visual style matches a reference (the reference is
# attached as a style/composition/mood reference only — never modified or saved)
/codex-image:style-gen reference.png "A coin in this exact style, transparent background, save to assets/icons/coin.png at 512x512"
/codex-image:style-gen "concepts/hero.png" "5 variations of small UI buttons in the same visual style, save under assets/ui/"
# Batch-orchestrate style-gen across a planned asset set (interactive: plans the
# list from your project context, asks you to confirm, then runs style-gen per
# item with a sample-first gate for batches > 10)
/codex-image:asset-pipeline reference.png "RPG mobile game: 5 enemies + 10 items + 4 backgrounds + UI buttons"
/codex-image:asset-pipeline concepts/hero.png "SaaS landing: hero, 4 section illustrations, OG image, favicon"
# Slice an atlas sheet into per-cell PNGs (uniform cell size, content auto-centered)
/codex-image:slice buttons.png buttons_sliced/ "4x5 grid, names primary/secondary/small/wide/icon × normal/hover/pressed/locked"
# Or slice every atlas-kind item in a manifest at once
/codex-image:slice --manifest codex-images/manifest-2026-05-12T08-00Z.json
