CLI Reference

ZSM provides a clean and intuitive interface for managing installation scripts and approvals.

Main Commands

install (Default)

Installs a package from a .zsm script.

Usage:

zsm install <path_or_url_to_script.zsm>
zsm script.zsm
cat script.zsm | zsm

Options:

• --dry-run: Simulate the installation without making changes.

list

Displays a list of all packages installed via ZSM.

zsm list

uninstall

Removes a package and all files tracked in its manifest.

zsm uninstall <package_name>

cache

Manage approved script permissions.

cache list

Displays a list of all unique script identifiers (hashes) currently trusted on your system.

zsm cache list

cache clean

Removes all stored approvals. Future script runs will require re-approval.

zsm cache clean

help

Prints the help message.

zsm help

Global Flags

• --dry-run: Can be used with the install command to perform a safety simulation.

Persistence

Approvals are stored in the user's cache directory:

• Linux/macOS: ~/.cache/zsm/

Each cache file is named after the SHA-512 hash of the script's URL to ensure uniqueness across different script providers.