Start here: welcome to imgcli 👋

[swperb]

imgcli is a tiny (~232 KB), dependency-free CLI to convert, resize, crop, filter, and composite images — an ffmpeg-style alternative to ImageMagick for still images, with agent-native JSON output.

Get started

• Install: brew install swperb/tap/imgcli (or grab a release)
• Try it: imgcli -i photo.jpg -vf "scale=800:-1,grayscale,gblur=2" out.png
• Docs: the README; AGENTS.md for scripting/agents.

Where things go

• 💡 Feature ideas → the Feature request issue template (or float it in Ideas first)
• 🐛 Bugs → the Bug report template
• 🖼️ Want a format? → the Format support request template. Note imgcli stays zero-dependency — simple formats (TIFF, QOI) get built in; WebP/AVIF are opt-in build flags.
• ❓ Questions → Q&A
• 🛠️ Contribute → CONTRIBUTING.md
• 🔒 Security → report privately (SECURITY.md)

See the pinned Roadmap for what's planned and how to help. Built something? Share it in Show and tell. 👋