---
id: cloudsmith-cli
version: "1.23.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# cloudsmith-cli — Cloudsmith Command-Line Interface (CLI)

License: permissive · Maintenance: active · Downloads: 370.2K/mo

## What it is and what it does

Cloudsmith CLI is a Python 3 text-based interface to the Cloudsmith package repository API, allowing teams to automate package management workflows without building custom integrations. It supports uploading, downloading, copying, and deleting packages across multiple formats (Python, npm, Docker, Maven, Debian, RPM, and many others), plus managing repositories, entitlements, metadata, and policies programmatically.

The tool is designed for DevOps automation and system administration tasks. It handles authentication via login, API keys, or keyring storage, and provides subcommands for nearly every operation available through the web API—from listing distributions and packages to managing quarantines, quotas, and vulnerability policies. With 17 runtime dependencies including click for CLI scaffolding, requests for HTTP, and rich for terminal output, it trades a moderate dependency footprint for a polished, feature-complete command-line experience.

Use it for:

- Automate package uploads in CI/CD pipelines for multiple package formats without writing format-specific scripts.
- Manage repository entitlements and access tokens programmatically across an organization.
- Promote or copy packages between repositories as part of release workflows.
- Query package metadata, dependencies, and vulnerability information from the command line.
- Integrate Cloudsmith operations into shell scripts or infrastructure-as-code tools.
- Retrieve bandwidth and storage metrics for repositories and entitlement tokens.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A command-line interface to the Cloudsmith package repository API, enabling users to manage packages, repositories, entitlements, and metadata across multiple package formats without writing custom integrations.

Yes. The package is actively maintained, carries no known vulnerabilities, supports current Python versions, and has low install friction. It is well-suited for teams already using Cloudsmith who need to automate package management or integrate repository operations into CI/CD and DevOps workflows. The permissive Apache-2.0 license poses no restrictions.

## Install

pip install cloudsmith-cli
uv add cloudsmith-cli
poetry add cloudsmith-cli

## Installing cloudsmith-cli

Before you install: Low install friction with a pure Python wheel distribution. Active maintenance with a release on 2026-08-14 and recent commits. Supports current Python versions (3.10–3.14) and carries 17 runtime dependencies including click, requests, and keyring for credential handling.

License in practice: Licensed under Apache-2.0 (permissive), allowing free use, modification, and distribution with minimal restrictions—suitable for both commercial and open-source projects.

Quickstart:

pip install cloudsmith-cli
cloudsmith --version
cloudsmith login
cloudsmith push python ./my-package.tar.gz my-org/my-repo

Requires Python 3.10 or later. API credentials (via login or CLOUDSMITH_API_KEY environment variable) needed for most operations.

Verify before relying:

- Whether the 17 runtime dependencies introduce any transitive security concerns beyond the 0 known OSV vulnerabilities in cloudsmith-cli itself.
- Performance characteristics when managing large numbers of packages or repositories.
- Whether keyring integration works reliably across all supported platforms (Linux, macOS, Windows).

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 370.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

cloudsmith cli package management, command line package repository, devops automation cli, package upload download cli, repository entitlements management, multi-format package push, api automation without plugins, devops-automation, package-management, api-client

[View on SkillFed](https://skillfed.io/packages/cloudsmith-cli) · [View on PyPI](https://pypi.org/project/cloudsmith-cli/)