hextile-knockout

name	hextile-knockout
description	Knock out black (or light) background — greyscale→alpha + solid fill. Use for art-on-black PNGs needing transparent matte.
user-invocable	true

hextile-knockout

Art-on-black PNG/JPG → RGBA: levels on luminance become alpha, RGB filled with a solid color (default white).

Run

ROOT="${HEXTILE_PIPE_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-${GROK_PLUGIN_ROOT:-${PLUGIN_ROOT:-}}}}"
bash "$ROOT/scripts/fp-run.sh" knockout <path> --new [flags…]

Agent default: always pass --new unless user insists on overwrite.

Common flags

Discover full set: bash "$ROOT/scripts/fp-run.sh" knockout -h

Flag	Meaning
--new	Sidecar file.ext.knockout.png (required for agents)
--recursive	Also process files in subfolders (default: this folder only)
--cutoff PCT	Levels black point 0–100 (default 3 — crush near-black / near-white after --invert)
--white PCT	Levels white point 0–100 (default 97 — crush near-white / near-black after --invert)
--black-point / --white-point	Raw luma 0–255 aliases
--gamma G	Midtone gamma on alpha
--color COLOR	Fill RGB: name, #rrggbb, or r,g,b (unused with --silhouette / --wand)
--invert	Dark art on light background
--silhouette	Key only --cutoff; keep original greys; blur then levels (default --blur 2 --lo 150 --hi 170)
--wand	Key only backdrop connected to the image edge (implies --silhouette). Seals 2px, floods, unseals. Interior black stays
--blur PX	Silhouette / wand: Gaussian on the matte (default 2; 0 = hard key)
--lo / --hi	Silhouette / wand: input levels on the blurred matte 0–255 (default 150–170)
--force	Allow reprocessing tagged outputs

Path rules

• Normalize Windows paths under WSL (D:\x → /mnt/d/x).
• JPEG has no alpha — use --new.
• Fence CLI output in the reply.