Simple Image Tool

A lightweight VS Code extension for quick image editing — right-click any image in the Explorer to get started, or use the @image-tool chat participant in GitHub Copilot.

Features

🤖 Chat Participant

Use natural language with @image-tool in GitHub Copilot Chat:

@image-tool convert logo.png to webp
@image-tool resize icon.png to 512x512
@image-tool remove white background from photo.jpg

Features:

• 🧠 AI-powered intent detection: Uses GPT-5 mini to understand natural language variations
  • Requires GitHub Copilot access permission
  • Automatically falls back to pattern-based parsing if permission is denied or Copilot is unavailable
• 🚀 Smart automation: Converts and resizes execute instantly when parameters are provided
• 🎨 Interactive matting: Configurable behavior — preview, auto-execute, or ask each time
• 📁 Flexible file references: Use filenames, paths, or drag & drop files into chat
• 💬 Natural commands: Understands synonyms and flexible phrasing

Learn more about the chat participant →

Convert Image Format

Right-click an image file and convert between JPG, PNG, WebP, and SVG.

Resize Image

Right-click an image file and enter a new size:

• 800x600 — exact dimensions
• 512x — set width, auto-calculate height
• x256 — set height, auto-calculate width

Image Matting

Remove background colors interactively or via chat:

Interactive Panel (right-click image):

1. Click on the image to pick colors you want to remove.
2. Adjust Tolerance and Feather sliders.
3. Click Apply Matting and save the result as PNG.

Chat Participant:

@image-tool remove white background from logo.png
@image-tool remove background from photo.jpg

Configure behavior via simple-image-tool.matting.autoExecute setting:

• preview (default) — Always open preview panel for quality control
• execute — Auto-execute when color is specified via chat
• ask — Prompt whether to preview or execute each time

Requirements

• uv — a fast Python package manager. Python dependencies (Pillow, numpy) are installed automatically on first use.
• GitHub Copilot (optional) — Enables AI-powered natural language understanding in chat participant. Extension works without Copilot using pattern-based intent parsing.

Extension Settings

Reset AI Permission: Run command "Simple Image Tool: Reset AI Permission" from Command Palette (Ctrl+Shift+P / Cmd+Shift+P) to re-enable AI or trigger a new permission request.

License

MIT