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 →
ideogramorrecraft - Photorealism →
bflorstability - 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