# Install imageoptim-cli with Homebrew

CLI for ImageOptim, ImageAlpha and JPEGmini. Version 3.1.9 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:imageoptim-cli
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install imageoptim-cli
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:imageoptim-cli
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/imageoptim-cli>
- **Version:** 3.1.9
- **Source summary:** CLI for ImageOptim, ImageAlpha and JPEGmini
- **Homepage:** <https://jamiemason.github.io/ImageOptim-CLI/>
- **Repository:** <https://github.com/JamieMason/ImageOptim-CLI>
- **Upstream docs:** <https://github.com/JamieMason/ImageOptim-CLI#readme>
- **License:** MIT
- **Source archive:** <https://github.com/JamieMason/ImageOptim-CLI/archive/refs/tags/3.1.9.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- imageoptim (cli)
- imageoptim (alias)

## Dependencies

- node

## Build dependencies

- yarn

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 3.1.9
- Local data: ok
- Upstream repository: https://github.com/JamieMason/ImageOptim-CLI
- Upstream latest detected: 3.1.9 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

ImageOptim-CLI is a macOS-focused command-line wrapper around ImageOptim, ImageAlpha, and JPEGmini. It exists to make GUI-first image optimizers usable from shell scripts, build steps, and package-managed developer environments.

### Project history

Jamie Mason published ImageOptim-CLI to npm in 2013, with the project changelog showing the 1.0.0 line on 2013-05-17. The README frames the package as automation for ImageOptim, ImageAlpha, and JPEGmini, and explains that the CLI depends on those applications rather than bundling them.

The project evolved from a JavaScript-era package into a TypeScript and AppleScript tool distributed as a self-contained executable. Version 2.0.0 in 2018 rewrote the core in Node.js, and the 3.x line tightened macOS app detection, temporary directory handling, Node runtime support, and JPEGmini compatibility.

### Adoption history

ImageOptim-CLI spread through npm and Homebrew because it filled a practical gap for front-end build pipelines on Macs: ImageOptim and related apps had strong compression results but were awkward to use unattended. The README also points to a companion Grunt plugin, an Alfred workflow, and a tool-comparison page that positioned the CLI in the web-performance tooling ecosystem.

Homebrew packages the tool as `imageoptim-cli`, while npm remains an upstream distribution channel. Homebrew analytics show a small but persistent install base, which fits its niche as a Mac-only automation bridge rather than a general cross-platform optimizer.

### How it is used

The `imageoptim` executable accepts file patterns and flags for enabling ImageAlpha or JPEGmini, disabling ImageOptim, controlling stats output, and selecting compression settings such as ImageAlpha color count and quality range. Its typical use is batch optimization from a terminal or build script.

Because JPEGmini automation simulates a GUI user, the README documents macOS accessibility permissions for that path. The package therefore sits in the unusual intersection of CLI automation, AppleScript, and GUI image applications.

### Why package nerds care

For package-manager users, ImageOptim-CLI is notable because it packages a workflow rather than a codec: the value is coordinating several native Mac apps behind one repeatable command. It is also a good example of Homebrew carrying a Node-derived binary for a workflow that only makes sense on macOS.

### Timeline

- 2013: ImageOptim-CLI 1.0.0 published to npm.
- 2013: The project was covered as a batch compression tool for optimized web images.
- 2018: Version 2.0.0 rewrote the core in Node.js.
- 2019: Version 3.0.0 changed missing-app cases from warnings to errors.
- 2023: Version 3.1.9 added Node 18 support and dependency updates.

### Related projects

- ImageOptim-CLI automates ImageOptim, ImageAlpha, and JPEGmini, and its README names `grunt-imageoptim` and an Alfred workflow as related projects. It also compares itself with optimizer services and tools such as Kraken.io, CodeKit, grunt-contrib-imagemin, Smush.it, and TinyPNG.

### Sources

- <https://formulae.brew.sh/api/formula/imageoptim-cli.json>
- <https://github.com/JamieMason/ImageOptim-CLI>
- <https://raw.githubusercontent.com/JamieMason/ImageOptim-CLI/main/CHANGELOG.md>
- <https://raw.githubusercontent.com/JamieMason/ImageOptim-CLI/main/README.md>
- <https://registry.npmjs.org/imageoptim-cli>


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool signal

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** imageoptim-cli
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Requirements:** macos
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [node](https://www.automicvault.com/pkg/brew/node/) - Runtime dependency declared by Homebrew.
- [yarn](https://www.automicvault.com/pkg/brew/yarn/) - Build dependency declared by Homebrew.
- [jpegoptim](https://www.automicvault.com/pkg/brew/jpegoptim/) - Shares av.db curated category or tags: cli, image-optimization, media.
- [optipng](https://www.automicvault.com/pkg/brew/optipng/) - Shares av.db curated category or tags: cli, image-optimization, media.
- [oxipng](https://www.automicvault.com/pkg/brew/oxipng/) - Shares av.db curated category or tags: cli, image-optimization, media.
- [pngcrush](https://www.automicvault.com/pkg/brew/pngcrush/) - Shares av.db curated category or tags: cli, image-optimization, media.
- [pngnq](https://www.automicvault.com/pkg/brew/pngnq/) - Shares av.db curated category or tags: cli, image-optimization, media.
- [pngquant](https://www.automicvault.com/pkg/brew/pngquant/) - Shares av.db curated category or tags: cli, image-optimization, media.
- [media-control](https://www.automicvault.com/pkg/brew/media-control/) - Shares av.db curated category or tags: automation, cli, macos, media.
- [caesiumclt](https://www.automicvault.com/pkg/brew/caesiumclt/) - Shares av.db curated category or tags: cli, image-optimization, media.

## Combined YAML source

View the package source record on GitHub. [combined/imageoptim-cli.yml](https://github.com/automic-vault/db/blob/main/combined/imageoptim-cli.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
