Download command added to the Cloudsmith CLI

We’ve introduced the cloudsmith download command to the Cloudsmith CLI, enabling users to programmatically retrieve packages from repositories. This command provides advanced filtering, bulk operations, and pre-execution validation features.

This update resolves the prior friction created by the lack of a native download utility, eliminating the need for manual web UI downloads or complex curl/wget workarounds for artifact retrieval.

Key capabilities

The cloudsmith download command is designed for flexible and automated artifact fetching:

  • Smart package discovery: Automatically finds the latest version of a package by name across all repository versions.
  • Targeted filtering: Supports filtering based on metadata such as version, format, OS, and architecture.
  • Bulk file retrieval: Use the --all-files flag to download all associated package assets (e.g., sources, javadoc, SBOMs).
  • Output control: Define a custom output directory for downloads using the --outfile option, particularly useful for bulk operations.
  • Validation: Utilize the --dry-run capability to see exactly which files would be downloaded without initiating the transfer.

Usage examples

Below are practical examples illustrating the command's flexibility:

  • Download the latest version of a package
cloudsmith download myorg/myrepo mypackage

  • Download to a specific directory
cloudsmith download myorg/myrepo mypackage --outfile /tmp/myfiles/

  • Download with filters
cloudsmith download myorg/myrepo mypackage --format deb --arch amd64 --os ubuntu

  • Download all arbitrary files
cloudsmith download myorg/myrepo mynugetpackage --all-files

The cloudsmith download command acts as a sophisticated file retrieval utility - think of it as a specialized wget for Cloudsmith. This is NOT a package manager pull command. Unlike tools such as docker pull, npm install, or pip install, this command does not:

  • Install packages into your local environment
  • Manage dependencies or perform package resolution
  • Set up package registries or configure local tooling
  • Modify your system's package state

Its function is to transfer the package files (binaries, archives, etc.) to your local filesystem for manual use, inspection, or further processing.

If you have feedback or questions about the Cloudsmith CLI, please contact us.

Keep up to date with our monthly product bulletin