Usage

Usage

setapp-cli <subcommand> [options]

Managing apps

List installed apps

setapp-cli list

Install an app

setapp-cli install Proxyman

Remove an app

setapp-cli remove Proxyman

Reinstall an app

Removes then reinstalls the app in a single step.

setapp-cli reinstall Proxyman

Check for available apps

Find locally installed apps (in /Applications) that are also available through Setapp:

setapp-cli check

Find and install them:

setapp-cli check --install

Bundle commands

Bundle commands manage a plain-text file of app names. See Bundle files for details on the file format.

Save installed apps

# Save to the default bundle (~/.setapp/bundle)
setapp-cli dump

# Save to a specific file
setapp-cli dump --file ~/dotfiles/setapp.bundle

dump can also be accessed as setapp-cli bundle dump.

Install from a bundle

# Install from the default bundle
setapp-cli bundle install

# Install from a specific file
setapp-cli bundle install --file ~/dotfiles/setapp.bundle

List bundle contents

setapp-cli bundle list

Check bundle against installed apps

Exits with code 1 if any apps in the bundle are not installed:

setapp-cli bundle check

Remove apps not in the bundle

Uninstalls any Setapp apps that are installed but not listed in the bundle file:

setapp-cli bundle cleanup

Edit the bundle file

Opens the bundle file in $EDITOR (or the default app if $EDITOR is unset):

setapp-cli bundle edit

Custom bundle path

All bundle commands accept --file (or -f) to specify a file other than the default ~/.setapp/bundle:

setapp-cli bundle install --file ~/dotfiles/setapp.bundle
setapp-cli bundle check -f ~/dotfiles/setapp.bundle

Global options

Flag	Description
-v, --verbose	Verbose output
-d, --debug	Debug output (sets SETAPP_DEBUG=1)
--version	Show version
-h, --help	Show help

Run setapp-cli help <subcommand> for detailed help on any command.