Skip to content
Zipic Docs

AI & CLI Integration

Zipic is more than a GUI app. Through its URL Scheme, you can drive every compression capability from a shell script, a CI pipeline, or an AI agent like Claude Code — all while keeping the privacy benefits of 100% local processing.

Command Line

Zipic does not ship a traditional CLI binary. Instead, you invoke it through macOS’s built-in open command, which forwards URL Scheme requests to the Zipic app.

A minimal example — compress one image to WebP at level 3:

Terminal window
open "zipic://compress?url=/path/to/image.png&level=3&format=webp"

That’s the whole pattern. From there you can chain url= parameters for batch jobs, point at folders for recursive compression, set width/height for resizing, and pick a directory to save into.

For the full parameter reference, batch examples, the Shortcuts download, and AppIntents details, see Integrating Zipic Capabilities.

AI Agent Skill (One-Command Install)

Claude Code and other agent-skill-compatible tools can install the Zipic skill in one command. Once installed, you can talk to your AI agent in natural language — “compress these screenshots”, “convert this PNG to WebP”, “shrink these images to 1920px wide” — and the agent will translate your intent into the right URL Scheme call.

Install the skill:

Terminal window
npx skills add okooo5km/Skills4U --skill zipic

What the Skill Does

Environment detection

Verifies macOS and a Zipic installation before running, with friendly install hints (Homebrew, Mac App Store, website) when missing.

Safe path handling

URL-encodes spaces and non-ASCII characters in file paths automatically. Batch loops handle whole folders without escaping headaches.

Sensible defaults

Recommends compression level 2–3 for everyday use, and picks a target format based on the use case — WebP/AVIF for the web, HEIC for the Apple ecosystem, JPEG for maximum compatibility.

Pro feature awareness

Knows which features (Notch Drop, clipboard auto-compress, folder watching) require Pro, and reminds you of the free-tier 25-compressions-per-day limit before hitting it.

Try It in Conversation

Once installed, ask your agent things like:

  • “Compress all the images in ~/Downloads/screenshots/.”
  • “Convert this PNG to WebP for the blog.”
  • “Resize these product photos to 1920px wide and save them as AVIF.”

The agent figures out the right level, format, width, and url parameters and runs the open command for you.

Use Cases

  • Build pipelines — compress static assets in CI before deploying to a CDN.
  • Blog automation — feed screenshots into a script that emits web-ready WebP/AVIF on save.
  • Bulk export — drop a folder onto a script and walk away.
  • Editor / IDE integration — plug Zipic into VS Code tasks or your AI coding assistant of choice.