hex/claude-image-generation

README preview

# claude-image-generation

Claude Code plugin for generating and editing images using Google Gemini, OpenAI GPT Image, xAI Grok Image, and OpenRouter APIs.

## Features

- **Text-to-image generation** with Google Gemini, OpenAI GPT Image 2, xAI Grok Image, or any image model on OpenRouter
- **OpenRouter gateway** — reach any OpenRouter image model (Gemini, GPT Image, and more) through one key via the chat-completions API
- **Image editing** with text instructions (all providers)
- **Multi-image input** — repeatable `--input-image` for multi-image edits (all providers) and Gemini reference-based generation
- **Parallel generation** across all providers via `scripts/run-all.sh` — one shared streaming pane, council-style colored banners, and a `waiting on` line naming the pending providers (animated until the first image renders, then written once under each block)
- **Interactive provider selection** via AskUserQuestion at runtime
- **Generate tool** on Claude Code builds with function hooks, so the model calls one typed tool instead of writing a script line (see [Generate Tool](#generate-tool-function-hooks-early-access))
- **Provider status** via `/claude-image-generation:status`, which checks each key and default model against the provider's live API without billing anything
- **Model fallback** draws with a configured second model when a provider's default is unavailable to your key (see [Model Fallback](#model-fallback))
- **Inline image preview** -- generated images display directly in the terminal (iTerm2, Kitty, Ghostty, WezTerm, Sixel terminals)
- **Tmux pane display** -- opens a split pane for image preview when running inside tmux (works with Claude Code). Providers running at the same time share one pane, however they were launched
- **Streaming display** -- images appear progressively in a shared pane during parallel generation, accumulating as each provider finishes
- **Open in Finder/Preview** -- press 'f' for Finder or 'p' for Preview in the display pane

View full repository on GitHub →