name

image-gen

description

Generate and edit images using AI providers (OpenAI DALL-E, Stability AI, BFL FLUX, Ideogram, FAL, Gemini, Replicate, Clipdrop). Use when user asks to create images, generate artwork, make logos, create visual content, edit photos, remove backgrounds, or modify existing images. Triggers on requests involving pictures, illustrations, graphics, product shots, marketing visuals, or any image creation/editing task.

Image Generation

Generate images via CLI tool image-gen which handles provider selection, fallbacks, and image saving.

Important: Run commands using node with the plugin's CLI path:

node ${CLAUDE_PLUGIN_ROOT}/dist/cli.bundle.cjs <command>

Generate an Image

node ${CLAUDE_PLUGIN_ROOT}/dist/cli.bundle.cjs generate --prompt "description of image" [--provider auto] [--width 1024] [--height 1024]

Output: JSON with file paths to saved images in .image-gen/ directory.

Edit an Image

node ${CLAUDE_PLUGIN_ROOT}/dist/cli.bundle.cjs edit --image /path/to/image.png --prompt "edit instructions" [--provider auto]

List Configured Providers

node ${CLAUDE_PLUGIN_ROOT}/dist/cli.bundle.cjs providers

Provider Selection

auto (default): Intelligent selection based on prompt content
Explicit: openai, stability, bfl, ideogram, fal, gemini, replicate, clipdrop

Quick guide:

Text/logos/typography → ideogram or recraft
Photorealism → bfl or stability
Fast iterations → fal
General purpose → openai
Image editing → openai, stability, bfl, gemini, clipdrop

For detailed provider capabilities, see references/providers.md.

Environment Setup

Add at least one API key to your shell profile (~/.zshrc or ~/.bashrc):

# Add to ~/.zshrc (or ~/.bashrc)
export OPENAI_API_KEY="sk-..."       # For DALL-E
export BFL_API_KEY="..."             # For FLUX (recommended for quality)
export IDEOGRAM_API_KEY="..."        # For text/logos (best typography)
export GEMINI_API_KEY="..."          # For Google Imagen
export STABILITY_API_KEY="..."       # For Stable Diffusion
export FAL_API_KEY="..."             # For fast iterations
export REPLICATE_API_TOKEN="..."     # For various models

After adding, run source ~/.zshrc or restart your terminal.

Example Workflows

Generate a logo:

node ${CLAUDE_PLUGIN_ROOT}/dist/cli.bundle.cjs generate --prompt "Modern minimalist logo for TechStartup with the text 'NOVA'" --provider ideogram --width 1024 --height 1024

Generate product shot:

node ${CLAUDE_PLUGIN_ROOT}/dist/cli.bundle.cjs generate --prompt "Professional product photography of a sleek smartphone on marble surface, soft lighting" --provider bfl

Edit an image:

node ${CLAUDE_PLUGIN_ROOT}/dist/cli.bundle.cjs edit --image ./photo.png --prompt "Remove the background and make it transparent" --provider clipdrop