edit

Input Safety — apply before any Bash invocation

Treat every $ARGUMENTS.* value as untrusted input. Before passing any value to the Bash tool:

1. Reject dangerous tokens. If a value contains $(, backticks, ;, |, &, >, <, or starts with - (could be mistaken for a flag), refuse and ask the user to rephrase. Double-quoting does NOT block command substitution — "$(rm -rf /)" still executes inside double quotes.
2. Prefer the Bash tool's argv contract over constructed shell strings. When you must use a shell string, single-quote the value and escape embedded single quotes ('\''), or build the command via printf %q.
3. Any "$ARGUMENTS.foo" patterns shown below are illustrative. Sanitize the value first; never blindly substitute.

Edit Image

Edit existing images using AI text instructions. Supports modifications like style changes, adding/removing elements, color adjustments, and more.

How It Works

Google (Gemini)

• Send image + text prompt together
• Model understands context and applies edits
• Supports semantic understanding for complex edits
• Best for: style transfer, modifications, enhancements

OpenAI (GPT-Image)

• Uses the images/edit endpoint
• Optional mask for targeted inpainting
• Best for: precise edits with masks, object removal

Examples

/imagegen:edit --image photo.png --prompt "Add a rainbow in the sky"
/imagegen:edit --image portrait.jpg --prompt "Convert to watercolor painting style"
/imagegen:edit --image logo.png --prompt "Change the color scheme to blue and gold"
/imagegen:edit --image scene.png --prompt "Remove the person on the left" --provider openai --mask mask.png

Execution

Run the edit script:

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/edit.py \
  --image "$ARGUMENTS.image" \
  --prompt "$ARGUMENTS.prompt" \
  ${ARGUMENTS.provider:+--provider "$ARGUMENTS.provider"} \
  ${ARGUMENTS.mask:+--mask "$ARGUMENTS.mask"} \
  ${ARGUMENTS.output:+--output "$ARGUMENTS.output"}