baoyu-compress-image

Auto-compresses images using the best available CLI tool on the system (sips, cwebp, convert, or sharp).

This has been specifically adapted for the Obsidian Creator Vault:

• Fast Web-focused: Defaults to generating .jpg with 65 quality (perfect for most platform limits < 1MB).
• Clean Vault: When run in default mode (replace), it doesn't clutter your Assets/ with _original files. Instead, it backs up the original unmodified file to Archive/Original-Images/.
• Dependency Sandboxing: All runtime is wrapped through bun and isolated inside .agents/skills.

Installation & System Requirements

This script automatically detects your OS and uses the fastest and highest quality image engine it can find in this order:

1. macOS sips (Built-in, Highly Recommended)
   macOS ships with sips natively. No installation required.
   (Under the hood: sips -s format jpeg -s formatOptions 65 <input> --out <output>)

2. cwebp (Best for webp targets)

   • macOS: brew install webp