Core CLI/CLI Core Commands & Flags
Docs/Core CLI/CLI Core Commands & Flags

CLI Core Commands & Flags

Comprehensive list of command-line flags, options, aspect ratios, and formatting controls.

The imagerry CLI formats, styles, and compresses images locally from your terminal.

Basic Syntax

|bash
# Single image
imagerry -i <input-file> -o <output-file> [options]

# Batch directory or glob
imagerry -i <input-dir> -o <output-dir> [options]
imagerry --batch "<glob>" -o <output-dir> [options]

Core Options

OptionTypeDefaultDescription
-i, --input <path>stringPath to input image file or directory
-o, --output <path>stringPath to output image file or directory
-f, --format <format>stringautoTarget format: png, jpeg, or webp
-q, --quality <num>number90Quality (1-100) for WebP and JPEG
-p, --preset <name>string"default"Preset name (mesh, gradient, cyberpunk, etc.)
-b, --batch <glob>stringBatch process multiple files matching a glob pattern
-c, --concurrency <n>number4Parallel workers for batch processing
--padding <num>numberDirect canvas padding override
--radius <num>numberDirect inner border radius override
--shadow <num>numberDirect drop shadow size override
--bg-color <hex>stringSolid background hex color
--ratio <ratio>stringAspect ratio (16:9, 1:1, 4:3, auto)
--license-key <key>stringenvImagerry Pro license key override
-v, --versionbooleanPrint CLI engine version (currently v0.2.0-beta)
-h, --helpbooleanShow all commands and options
👉

Quick Examples

1. Convert & Style to WebP

|bash
imagerry -i hero.png -o hero.webp -q 85 --preset mesh

2. Direct Style Overrides

|bash
imagerry -i app.png -o app.png --preset gradient --padding 48 --radius 20

3. Batch Process a Folder

|bash
imagerry -i ./screenshots -o ./dist --preset cyberpunk --format webp

4. Initialize Project Config

|bash
imagerry init --preset mesh
Found an issue or typo? Report on GitHub
Imagerry CLI Docs • v0.2.0-beta