npm / sharp-cli
sharp-cli
What changed in sharp-cli 5 to 6, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-18.
4 breaking15 new APIs and options3 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli initsharp-cli 616 changes
Breaking changes 3
Tightens option configuration so options require values.
Removes the jpg output format alias; use jpeg instead.
Requires Node.js 20.10.
New APIs and options 11
Added an output template for preserving directories matched by glob inputs.
The resize command now supports percentage-based dimensions.
Adds an option to process images without writing output files.
Adds an output option.
Adds an output option for keeping a gain map.
Adds an input option to limit input channels.
Adds an option to print input and output metadata as JSON.
Adds the --margin option to the trim command.
Adds an output option.
Adds an output option.
Adds an output option for including a gain map.
Fixes and other changes 2
Fixes a bug where format options could cause errors.
Adds graceful handling of partial failures during batch image processing.
sharp-cli 56 changes
Breaking changes 1
Version 5.3.0 is the last release compatible with Node.js 18.
New APIs and options 4
Added the --bigtiff output option.
Added the dilate operation.
Added the erode operation.
Added the --keepDuplicateFrames output option.
Fixes and other changes 1
Fixed a bug that silently ignored numeric option values of zero, including --compressionLevel, --dither, --delay, and --effort.