hextile-despeckle

name	hextile-despeckle
description	Despeckle dust/freckles on black-bg or transparent art via min-area components + levels; scale-aware and multi-pass.
user-invocable	true

hextile-despeckle

Removes small islands on black-bg or transparent coverage (not RGB blur).

Run

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

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

Common flags

bash "$ROOT/scripts/fp-run.sh" despeckle -h

Flag	Meaning
--new	Sidecar file.despeckle.png
--recursive	Also process files in subfolders (default: this folder only)
--mode auto|alpha|black	Coverage source
--min-area N	Drop components under N pixels (default 4)
--min-area-rel F	Scale-aware: max(1, round(F × long_edge²)); exclusive with --min-area
--passes P	Repeat cleanup P times (default 1)
--cutoff / --white	Levels 0–100
--black-point / --white-point	Levels 0–255 aliases
--gamma	Midtone gamma
--to-alpha	BLACK mode: emit RGBA
--color / --invert	Fill / invert

Path rules

• WSL-normalize paths. Fence CLI output.