Bundle files

Bundle files

A bundle file is a plain-text list of Setapp app names, one per line. It serves the same purpose as a Brewfile -- save it to your dotfiles repo, then restore your apps on any Mac.

Format

# setapp bundle -- 2025-01-01
# Run `setapp-cli bundle install` to reinstall on a new Mac.

Proxyman
CleanShot X
Bartender 5
iStat Menus    # inline comments are fine

• One app name per line
• Lines starting with # are comments
• Inline # comments are stripped
• Blank lines are ignored
• App names must match exactly as they appear in Setapp

Default location

The default bundle file is ~/.setapp/bundle. This is created automatically by setapp-cli dump.

Typical workflow

Initial setup

# Save your current apps
setapp-cli dump

# Copy the bundle to your dotfiles
cp ~/.setapp/bundle ~/dotfiles/setapp.bundle

New Mac

# Restore your apps
setapp-cli bundle install --file ~/dotfiles/setapp.bundle

Ongoing maintenance

# Check if anything is missing
setapp-cli bundle check

# Remove apps you no longer want
setapp-cli bundle cleanup

# Update the bundle after installing new apps
setapp-cli dump