diegosouzapw QASAI - Image Compression CLI
Installation
npx qasai
# or install globally
npm install -g qasai
When to Use
- Compressing images for web optimization
- Batch processing image directories
- Converting between image formats (JPG, PNG, WebP, AVIF)
- Resizing images while maintaining aspect ratio
- Lossless optimization without quality loss
Supported Formats
JPEG, PNG, WebP, AVIF, GIF, TIFF, SVG
Usage
Interactive Mode
npx qasai
Launches guided prompts for compression options.
Direct Compression
npx qasai [input] [options]
If you pass an input path or any options, it runs compression directly.
Common Workflows
1. Basic Compression (Web Optimized)
npx qasai ./images -q 80 -w 1920 -r
2. Maximum Compression
npx qasai ./images -q 60 -j mozjpeg -p pngquant
3. Lossless Optimization
npx qasai ./images -j jpegtran -p optipng -l
4. Convert to Modern Formats
# WebP (good browser support)
npx qasai ./images -f webp -q 80
# AVIF (best compression)
npx qasai ./images -f avif -q 70
5. Resize Images
# Max width 1920px (maintains aspect ratio)
npx qasai ./images -w 1920
# Specific dimensions
npx qasai ./images -s 800x600
# Scale to 50%
npx qasai ./images -s 50%
6. In-Place Compression (Overwrite Originals)
# With backup
npx qasai ./images -i -B -q 80
# Without backup (destructive)
npx qasai ./images -i -q 80
7. Custom Output Directory
npx qasai ./images -o ./compressed
8. Scripting & Automation
# Quiet mode (only errors)
npx qasai ./images -Q -q 80
# JSON output for parsing
npx qasai ./images --json
# Skip existing files
npx qasai ./images -S
# Dry run (preview)
npx qasai ./images -D
9. Performance
# Parallel processing (8 workers)
npx qasai ./images -P 8 -r
CLI Options Reference
| Short | Long | Description | Default |
|---|---|---|---|
-o |
--output <dir> |
Output directory | qasai/ folder |
-i |
--in-place |
Overwrite original files | false |
-q |
--quality <n> |
Quality 1-100 | 80 |
-l |
--lossless |
Lossless compression | false |
-s |
--resize <dim> |
Resize (e.g., 800x600, 50%) |
- |
-w |
--max-width <px> |
Max width (keeps aspect ratio) | - |
-H |
--max-height <px> |
Max height (keeps aspect ratio) | - |
-f |
--format <fmt> |
Convert to format (jpg, png, webp, avif) | - |
-r |
--recursive |
Process subdirectories | false |
-m |
--keep-metadata |
Preserve EXIF data | false |
-e |
--effort <n> |
Compression effort 1-10 | 6 |
-j |
--jpeg-engine <e> |
mozjpeg, jpegtran, sharp | mozjpeg |
-p |
--png-engine <e> |
pngquant, optipng, sharp | pngquant |
-g |
--gif-engine <e> |
gifsicle, sharp | gifsicle |
-c |
--colors <n> |
Max colors for PNG/GIF | 256 |
-D |
--dry-run |
Preview without compressing | false |
-Q |
--quiet |
Silent mode (only errors) | false |
--json |
Output results as JSON | false |
|
-S |
--skip-existing |
Skip existing output files | false |
-P |
--parallel <n> |
Parallel processing workers | 4 |
-B |
--backup |
Backup before in-place compression | false |
Compression Engines
JPEG Engines
- mozjpeg (default): Best compression, 5-10% smaller than libjpeg
- jpegtran: Pure lossless, only reorganizes data
- sharp: Fastest option
PNG Engines
- pngquant (default): 60-80% size reduction, reduces to 256 colors
- optipng: Pixel-perfect lossless
- sharp: Fast with good compression
GIF Engine
- gifsicle (default): Best for animated GIFs, preserves animation
Output
Results show per-file:
- Original size
- Compressed size
- Bytes saved
- Percentage saved
- Time elapsed
Examples for Agents
When user asks to optimize images:
# Default web optimization
npx qasai ./path/to/images -r -q 80
# For production deployment
npx qasai ./public/images -r -w 1920 -f webp -o ./public/optimized
When user wants lossless:
npx qasai ./images -j jpegtran -p optipng
When user wants smallest file size:
npx qasai ./images -q 60 -f avif
When scripting/automation:
# JSON output for parsing
npx qasai ./images --json -Q
# Skip already processed
npx qasai ./images -S -o ./out
References
- Full Specification - Detailed CLI specification and all options