@supertype.ai/storing

CLI tool for Storing — cloud image optimization. Automatically classify, compress, and deliver optimized assets from your S3 and GCS buckets.

Install

npm install -g @supertype.ai/storing

Requires Node.js 18+.

Quick Start

# Create an account at https://use.storing.app, then:
storing login --email [email protected] --password yourpassword

# Compress a single file
storing compress image.png

# Specify format and profile
storing compress image.png --format avif --profile aggressive

# Compress a directory
storing compress ./images/ --recursive

# Audit a bucket (project savings without modifying files)
storing audit s3://my-bucket

# Optimize an entire bucket
storing optimize s3://my-bucket --format avif --profile balanced

Commands

| Command | Description | |---------|-------------| | storing login | Authenticate with your account | | storing register | Create a new account | | storing compress | Compress local images via the cloud pipeline | | storing audit | Scan a bucket or directory and project savings | | storing optimize | Optimize all images in a connected bucket | | storing connect | Connect an S3 or GCS bucket | | storing status | Check job progress | | storing apply | Apply optimized files from staging | | storing history | View past jobs | | storing logout | Clear saved credentials |

Compression Options

| Flag | Default | Description | |------|---------|-------------| | -f, --format | auto | Output format: avif, webp, jpeg, png, original, auto | | -p, --profile | balanced | Quality profile: conservative, balanced, aggressive | | --max-size | — | Target max file size (e.g. 200KB) | | --min-quality | — | Minimum quality score floor | | -o, --output | — | Output directory | | -r, --recursive | false | Process directories recursively | | --json | false | Machine-readable JSON output |

Classification

Every image is classified into one of three tiers, each with optimized compression settings:

• Icon (≤512px) — favicons, sprites, thumbnails
• Standard (513–1919px) — product images, content photos
• Hero (≥1920px) — banners, backgrounds, full-width images

Links

• Website: storing.app
• Dashboard: use.storing.app
• Docs: storing.app/docs
• MCP Server: @supertype.ai/storing-mcp

License

MIT