fix(cli): correct linebreaks in command help.

cloudsmith_cli/cli/commands/credential_helper/__init__.py

@@ -27,18 +27,20 @@ def credential_helper():
     manager automatically, or run the runtime command directly for debugging.
 
     Examples:
+
+    \b
         # Install Docker credential helper
         $ cloudsmith credential-helper install docker
-
+    \b
         # Install pnpm credential helper
         $ cloudsmith credential-helper install pnpm
-
+    \b
         # Install cargo credential helper
         $ cloudsmith credential-helper install cargo
-
+    \b
         # Test Docker credential helper directly
         $ echo "docker.cloudsmith.io" | cloudsmith credential-helper docker
-
+    \b
         # Test pnpm credential helper directly
         $ cloudsmith credential-helper pnpm npm.cloudsmith.io
     """

cloudsmith_cli/cli/commands/credential_helper/docker.py

@@ -33,23 +33,30 @@ def docker(opts, operation):
     ``workspace`` in ``config.ini``; legacy aliases are also accepted - and a
     valid API key/token).
 
+    \b
     Input (stdin):
         Server URL as plain text (e.g. "docker.cloudsmith.io")
 
+    \b
     Output (stdout):
         JSON: {"Username": "token", "Secret": "<cloudsmith-token>"}
 
+    \b
     Exit codes:
         0: Success
         1: Error (no credentials available, not a Cloudsmith registry, etc.)
 
+    \b
     Examples:
+
+    \b
         # Manual testing
         $ echo "docker.cloudsmith.io" | cloudsmith credential-helper docker
-
+    \b
         # Called by Docker via launcher
         $ echo "docker.cloudsmith.io" | docker-credential-cloudsmith get
 
+    \b
     Environment variables:
         CLOUDSMITH_API_KEY: API key for authentication (optional)
         CLOUDSMITH_WORKSPACE: Workspace slug (CLOUDSMITH_ORG is also accepted)

cloudsmith_cli/cli/commands/credential_helper/terraform.py

@@ -92,13 +92,15 @@ def terraform(opts, repo, params):
 
     \b
     Examples:
+
+    \b
         # Direct usage
         $ cloudsmith credential-helper terraform --repo my-repo terraform.cloudsmith.io
         {"token": "..."}
-
+    \b
         # Terraform's calling convention (verb + hostname)
         $ cloudsmith credential-helper terraform --repo my-repo get terraform.cloudsmith.io
-
+    \b
         # Select an org and profile explicitly (no env vars needed)
         $ cloudsmith credential-helper terraform --org=acme -P ci get terraform.cloudsmith.io
 

cloudsmith_cli/cli/commands/domains.py

@@ -162,6 +162,7 @@ def list_domains(  # pylint: disable=too-many-arguments
     paginated endpoint, so there is no benefit to hiding entries by default.
     Passing --page or --page-size switches to paged output.
 
+    \b
     Output (stdout):
         JSON: {"version": 1, "domains": [{"host": ..., "format": ...,
         "type": ..., "domain_type": ..., "workspace": ..., "repository": ...,

cloudsmith_cli/cli/commands/entitlements.py

@@ -199,16 +199,16 @@
 
     rows = []
     for entitlement in sorted(data, key=itemgetter("name")):
         name = entitlement.get("name", "")
         user = entitlement.get("user", "")
         updated_at = fmt_datetime(entitlement.get("updated_at", ""))
         created_at = fmt_datetime(entitlement.get("created_at", ""))
         is_active = entitlement.get("is_active", "")
         is_limited = entitlement.get("is_limited", "")
 
         scheduled_reset_period = entitlement.get("scheduled_reset_period", "")
         limit_bandwidth = entitlement.get("limit_bandwidth", "")
         limit_bandwidth_unit = entitlement.get("limit_bandwidth_unit", "")
         limit_num_clients = entitlement.get("limit_num_clients", "")
         limit_num_downloads = entitlement.get("limit_num_downloads", "")
         limit_date_range_from = fmt_datetime(
@@ -775,14 +775,15 @@
 
     Full CLI example:
 
-      $ cloudsmith entitlements restrict cloudsmith/testing-private/9xGSdAxlIqIV \
-        --limit-bandwidth=1 \
-        --limit-bandwidth-unit=gigabyte \
-        --limit-num-clients=10 \
-        --limit-num-downloads=1000 \
-        --limit-package-query="package-darwin-amd64 OR package-windows-amd64 OR package-linux-amd64" \
-        --limit-path-query=tag:latest \
-        --limit-date-range-from=2020-01-01T00:00:00Z \
+    \b
+      $ cloudsmith entitlements restrict cloudsmith/testing-private/9xGSdAxlIqIV \\
+        --limit-bandwidth=1 \\
+        --limit-bandwidth-unit=gigabyte \\
+        --limit-num-clients=10 \\
+        --limit-num-downloads=1000 \\
+        --limit-package-query="package-darwin-amd64 OR package-windows-amd64 OR package-linux-amd64" \\
+        --limit-path-query=tag:latest \\
+        --limit-date-range-from=2020-01-01T00:00:00Z \\
         --limit-date-range-to=2077-01-01T00:00:00Z
     """
     owner, repo, identifier = owner_repo_identifier

cloudsmith_cli/cli/commands/list_.py

@@ -195,6 +195,7 @@ def packages(ctx, opts, owner_repo, page, page_size, query, sort, page_all):
 
     --query 'name:^foo$ filename:.zip$ architecture:~x86'
 
+    \b
     You can sort the results using --sort with these fields:
       - date/-date: Sort by creation date
       - downloads/-downloads: Sort by download count

cloudsmith_cli/cli/commands/mcp.py

@@ -200,6 +200,7 @@ def configure(ctx, opts, client, is_global):  # pylint: disable=unused-argument
     """
     Configure the Cloudsmith MCP server for supported clients.
 
+    \b
     This command automatically adds the Cloudsmith MCP server configuration
     to the specified client's configuration file. Supported clients are:
     - Claude Desktop
@@ -211,11 +212,12 @@ def configure(ctx, opts, client, is_global):  # pylint: disable=unused-argument
     For Claude Code, --global edits ~/.claude.json (user scope) and
     --local writes ./.mcp.json (project scope, intended to be committed).
 
-    Examples:\n
-        cloudsmith mcp configure --client claude\n
-        cloudsmith mcp configure --client claude-code\n
-        cloudsmith mcp configure --client cursor --local\n
-        cloudsmith mcp configure --client gemini-cli\n
+    \b
+    Examples:
+        cloudsmith mcp configure --client claude
+        cloudsmith mcp configure --client claude-code
+        cloudsmith mcp configure --client cursor --local
+        cloudsmith mcp configure --client gemini-cli
         cloudsmith mcp configure  # Auto-detect and configure all
     """
 

cloudsmith_cli/cli/commands/metadata.py

@@ -463,6 +463,7 @@ def remove_metadata(ctx, opts, owner_repo_package, metadata_slug_perm, yes):
     """
     Remove package metadata.
 
+    \b
     OWNER/REPO/PACKAGE: target package.
     METADATA_SLUG_PERM: permanent slug for the metadata entry.