Getting Started

Get the CLI installed and running in a few minutes.

Installation

The CLI is bundled with the Derivv Pro desktop app. To install the derivv command, open the desktop app and go to Settings → CLI and click Install CLI.

This creates a symlink at /usr/local/bin/derivv that points to the binary bundled inside the app. On macOS you may be prompted for your password to write to /usr/local/bin.

Once installed, verify it's working:

derivv --version

If you update the desktop app, re-run the install from Settings → CLI to point the symlink at the new version.

Authentication

The CLI shares its session with the desktop app — there is no separate login. As long as you are signed into the desktop app with an active Derivv Pro subscription, the CLI will work.

To check your account status:

derivv status

This shows your version, account email, plan, and session status. If the session has expired, open the desktop app and sign in again.

An active subscription is required. If you see "You're not signed in", open the desktop app and sign in.

Your first resize

Resize a single image to 800×600:

derivv resize photo.jpg -o resized.jpg -w 800 -H 600

Or use a saved preset to batch-process a directory:

derivv batch ./photos -o ./output -C "my-preset"

Presets created in the desktop app are immediately available in the CLI, and vice versa.

Next steps

See the command reference for the full list of commands and options
Use derivv <command> --help for inline help on any command