nextmv 1.0.0.dev3__py3-none-any.whl → 1.0.0.dev4__py3-none-any.whl

nextmv/cli/cloud/shadow/stop.py

@@ -21,17 +21,15 @@ def stop(
     """
     Stops a Nextmv Cloud shadow test.
 
-    Before stopping a shadow test, it must be in a started state. You may
-    use the [code]nextmv cloud shadow start[/code] command to start
-    a shadow test. Alternatively, define a [code]--start-time[/code] when using
-    the [code]nextmv cloud shadow create[/code] command to have the shadow test
-    start automatically at a specific time.
+    Before stopping a shadow test, it must be in a started state. Experiments
+    in a [magenta]draft[/magenta] state, that haven't started, can be deleted
+    with the [code]nextmv cloud shadow delete[/code] command.
 
     [bold][underline]Examples[/underline][/bold]
 
     - Stop the shadow test with the ID [magenta]hop-analysis[/magenta] from application
       [magenta]hare-app[/magenta].
-        $ [green]nextmv cloud shadow stop --app-id hare-app --shadow-test-id hop-analysis[/green]
+        $ [dim]nextmv cloud shadow stop --app-id hare-app --shadow-test-id hop-analysis[/dim]
     """
 
     in_progress(msg="Stopping shadow test...")

nextmv/cli/cloud/shadow/update.py

@@ -57,17 +57,17 @@ def update(
     [bold][underline]Examples[/underline][/bold]
 
     - Update the name of a shadow test.
-        $ [green]nextmv cloud shadow update --app-id hare-app --shadow-test-id carrot-feast \\
-            --name "Spring Carrot Harvest"[/green]
+        $ [dim]nextmv cloud shadow update --app-id hare-app --shadow-test-id carrot-feast \\
+            --name "Spring Carrot Harvest"[/dim]
 
     - Update the description of a shadow test.
-        $ [green]nextmv cloud shadow update --app-id hare-app --shadow-test-id bunny-hop-routes \\
-            --description "Optimizing hop paths through the meadow"[/green]
+        $ [dim]nextmv cloud shadow update --app-id hare-app --shadow-test-id bunny-hop-routes \\
+            --description "Optimizing hop paths through the meadow"[/dim]
 
     - Update both name and description and save the result.
-        $ [green]nextmv cloud shadow update --app-id hare-app --shadow-test-id lettuce-delivery \\
+        $ [dim]nextmv cloud shadow update --app-id hare-app --shadow-test-id lettuce-delivery \\
             --name "Warren Lettuce Express" --description "Fast lettuce delivery to all burrows" \\
-            --output updated-shadow-test.json[/green]
+            --output updated-shadow-test.json[/dim]
     """
 
     cloud_app = build_app(app_id=app_id, profile=profile)

nextmv/cli/cloud/switchback/create.py

@@ -44,6 +44,8 @@ def create(
             "-u",
             help="Duration of each interval in minutes.",
             metavar="UNIT_DURATION_MINUTES",
+            min=1,
+            max=10080,
         ),
     ],
     units: Annotated[
@@ -53,6 +55,8 @@ def create(
             "-t",
             help="Total number of intervals in the switchback test.",
             metavar="UNITS",
+            min=1,
+            max=1000,
         ),
     ],
     description: Annotated[
@@ -90,7 +94,7 @@ def create(
             "-r",
             formats=["%Y-%m-%dT%H:%M:%S%z"],
             help="Scheduled time for switchback test start in [magenta]RFC 3339[/magenta] format. "
-            "Example: [magenta]'2024-01-01T00:00:00Z'[/magenta]",
+            "Object format: [dim]'2024-01-01T00:00:00Z'[/dim]",
             metavar="START",
         ),
     ] = None,
@@ -99,33 +103,33 @@ def create(
     """
     Create a new Nextmv Cloud switchback test in draft mode.
 
-    The test will alternate between the [code]--baseline-instance-id[/code] and
-    [code]--candidate-instance-id[/code] over specified time intervals.
+    The test will alternate between the --baseline-instance-id and
+    --candidate-instance-id over specified time intervals.
 
-    You may specify the [code]--start[/code] option to make the switchback
-    test start at a specific time. Alternatively, you may use the
-    [code]nextmv cloud switchback start[/code] command to start the test.
+    You may specify the --start option to make the switchback test start at a
+    specific time. Alternatively, you may use the [code]nextmv cloud switchback
+    start[/code] command to start the test.
 
     Use the [code]nextmv cloud switchback stop[/code] command to stop the test.
 
     [bold][underline]Examples[/underline][/bold]
 
-    - Create a switchback test alternating between two bunny instances:
-        $ [green]nextmv cloud switchback create --app-id hare-app --switchback-test-id bunny-switch-hop \\
+    - Create a switchback test alternating between two bunny instances.
+        $ [dim]nextmv cloud switchback create --app-id hare-app --switchback-test-id bunny-switch-hop \\
             --name "Bunny Switch Hop" --baseline-instance-id fluffy-bunny-baseline \\
-            --candidate-instance-id speedy-cottontail --unit-duration-minutes 15 --units 10[/green]
+            --candidate-instance-id speedy-cottontail --unit-duration-minutes 15 --units 10[/dim]
 
-    - Create a switchback test with a scheduled start time:
-        $ [green]nextmv cloud switchback create --app-id hare-app --switchback-test-id sunrise-switch \\
+    - Create a switchback test with a scheduled start time.
+        $ [dim]nextmv cloud switchback create --app-id hare-app --switchback-test-id sunrise-switch \\
             --name "Sunrise Switch Test" --baseline-instance-id wise-old-rabbit \\
             --candidate-instance-id burrow-master --unit-duration-minutes 30 --units 8 \\
-            --start '2026-01-23T10:00:00Z'[/green]
+            --start '2026-01-23T10:00:00Z'[/dim]
 
-    - Create a switchback test with a description:
-        $ [green]nextmv cloud switchback create --app-id hare-app --switchback-test-id carrot-switch \\
+    - Create a switchback test with a description.
+        $ [dim]nextmv cloud switchback create --app-id hare-app --switchback-test-id carrot-switch \\
             --name "Carrot Switch" --baseline-instance-id fluffy-bunny-baseline \\
             --candidate-instance-id hopping-candidate-ears --unit-duration-minutes 20 --units 12 \\
-            --description "Which bunny hops best for carrots?"[/green]
+            --description "Which bunny hops best for carrots?"[/dim]
     """
 
     cloud_app = build_app(app_id=app_id, profile=profile)

nextmv/cli/cloud/switchback/delete.py

@@ -5,9 +5,9 @@ This module defines the cloud switchback delete command for the Nextmv CLI.
 from typing import Annotated
 
 import typer
-from rich.prompt import Confirm
 
 from nextmv.cli.configuration.config import build_app
+from nextmv.cli.confirm import get_confirmation
 from nextmv.cli.message import info, success
 from nextmv.cli.options import AppIDOption, ProfileOption, SwitchbackTestIDOption
 
@@ -33,24 +33,23 @@ def delete(
     Deletes a Nextmv Cloud switchback test.
 
     This action is permanent and cannot be undone. The switchback test and all
-    associated data, including runs, will be deleted. Use the [code]--yes[/code]
+    associated data, including runs, will be deleted. Use the --yes
     flag to skip the confirmation prompt.
 
     [bold][underline]Examples[/underline][/bold]
 
     - Delete the switchback test with the ID [magenta]hop-analysis[/magenta] from application
       [magenta]hare-app[/magenta].
-        $ [green]nextmv cloud switchback delete --app-id hare-app --switchback-test-id hop-analysis[/green]
+        $ [dim]nextmv cloud switchback delete --app-id hare-app --switchback-test-id hop-analysis[/dim]
 
     - Delete the switchback test without confirmation prompt.
-        $ [green]nextmv cloud switchback delete --app-id hare-app --switchback-test-id carrot-routes --yes[/green]
+        $ [dim]nextmv cloud switchback delete --app-id hare-app --switchback-test-id carrot-routes --yes[/dim]
     """
 
     if not yes:
-        confirm = Confirm.ask(
+        confirm = get_confirmation(
             f"Are you sure you want to delete switchback test [magenta]{switchback_test_id}[/magenta] "
             f"from application [magenta]{app_id}[/magenta]? This action cannot be undone.",
-            default=False,
         )
 
         if not confirm:

nextmv/cli/cloud/switchback/get.py

@@ -37,11 +37,11 @@ def get(
 
     - Get the switchback test with ID [magenta]carrot-optimization[/magenta] from application
       [magenta]hare-app[/magenta].
-        $ [green]nextmv cloud switchback get --app-id hare-app --switchback-test-id carrot-optimization[/green]
+        $ [dim]nextmv cloud switchback get --app-id hare-app --switchback-test-id carrot-optimization[/dim]
 
     - Get the switchback test using a specific profile.
-        $ [green]nextmv cloud switchback get --app-id hare-app --switchback-test-id lettuce-routes \\
-            --profile prod[/green]
+        $ [dim]nextmv cloud switchback get --app-id hare-app --switchback-test-id lettuce-routes \\
+            --profile prod[/dim]
     """
 
     cloud_app = build_app(app_id=app_id, profile=profile)

nextmv/cli/cloud/switchback/list.py

@@ -38,13 +38,13 @@ def list(
     [bold][underline]Examples[/underline][/bold]
 
     - List all switchback tests for application [magenta]hare-app[/magenta].
-        $ [green]nextmv cloud switchback list --app-id hare-app[/green]
+        $ [dim]nextmv cloud switchback list --app-id hare-app[/dim]
 
     - List all switchback tests and save to a file.
-        $ [green]nextmv cloud switchback list --app-id hare-app --output tests.json[/green]
+        $ [dim]nextmv cloud switchback list --app-id hare-app --output tests.json[/dim]
 
     - List all switchback tests using a specific profile.
-        $ [green]nextmv cloud switchback list --app-id hare-app --profile prod[/green]
+        $ [dim]nextmv cloud switchback list --app-id hare-app --profile prod[/dim]
     """
 
     cloud_app = build_app(app_id=app_id, profile=profile)

nextmv/cli/cloud/switchback/metadata.py

@@ -41,16 +41,16 @@ def metadata(
 
     - Get metadata for switchback test [magenta]bunny-warren-optimization[/magenta] from application
       [magenta]hare-app[/magenta].
-        $ [green]nextmv cloud switchback metadata --app-id hare-app \\
-            --switchback-test-id bunny-warren-optimization[/green]
+        $ [dim]nextmv cloud switchback metadata --app-id hare-app \\
+            --switchback-test-id bunny-warren-optimization[/dim]
 
     - Get metadata and save to a file.
-        $ [green]nextmv cloud switchback metadata --app-id hare-app --switchback-test-id lettuce-delivery \\
-            --output metadata.json[/green]
+        $ [dim]nextmv cloud switchback metadata --app-id hare-app --switchback-test-id lettuce-delivery \\
+            --output metadata.json[/dim]
 
     - Get metadata using a specific profile.
-        $ [green]nextmv cloud switchback metadata --app-id hare-app --switchback-test-id hop-schedule \\
-            --profile prod[/green]
+        $ [dim]nextmv cloud switchback metadata --app-id hare-app --switchback-test-id hop-schedule \\
+            --profile prod[/dim]
     """
 
     cloud_app = build_app(app_id=app_id, profile=profile)

nextmv/cli/cloud/switchback/start.py

@@ -23,15 +23,15 @@ def start(
 
     Before starting a switchback test, it must be created in draft state. You
     may use the [code]nextmv cloud switchback create[/code] command to create a
-    new switchback test. Alternatively, define a [code]--start[/code] when
-    using the [code]nextmv cloud switchback create[/code] command to have the
-    switchback test start automatically at a specific time.
+    new switchback test. Alternatively, define a --start when using the
+    [code]nextmv cloud switchback create[/code] command to have the switchback
+    test start automatically at a specific time.
 
     [bold][underline]Examples[/underline][/bold]
 
     - Start the switchback test with the ID [magenta]hop-analysis[/magenta] from application
       [magenta]hare-app[/magenta].
-        $ [green]nextmv cloud switchback start --app-id hare-app --switchback-test-id hop-analysis[/green]
+        $ [dim]nextmv cloud switchback start --app-id hare-app --switchback-test-id hop-analysis[/dim]
     """
 
     in_progress(msg="Starting switchback test...")

nextmv/cli/cloud/switchback/stop.py

@@ -21,17 +21,15 @@ def stop(
     """
     Stops a Nextmv Cloud switchback test.
 
-    Before stopping a switchback test, it must be in a started state. You may
-    use the [code]nextmv cloud switchback start[/code] command to start a
-    switchback test. Alternatively, define a [code]--start[/code] when using
-    the [code]nextmv cloud switchback create[/code] command to have the
-    switchback test start automatically at a specific time.
+    Before stopping a switchback test, it must be in a started state. Experiments
+    in a [magenta]draft[/magenta] state, that haven't started, can be deleted
+    with the [code]nextmv cloud switchback delete[/code] command.
 
     [bold][underline]Examples[/underline][/bold]
 
     - Stop the switchback test with the ID [magenta]hop-analysis[/magenta] from application
       [magenta]hare-app[/magenta].
-        $ [green]nextmv cloud switchback stop --app-id hare-app --switchback-test-id hop-analysis[/green]
+        $ [dim]nextmv cloud switchback stop --app-id hare-app --switchback-test-id hop-analysis[/dim]
     """
 
     in_progress(msg="Stopping switchback test...")

nextmv/cli/cloud/switchback/update.py

@@ -57,17 +57,17 @@ def update(
     [bold][underline]Examples[/underline][/bold]
 
     - Update the name of a switchback test.
-        $ [green]nextmv cloud switchback update --app-id hare-app --switchback-test-id carrot-feast \\
-            --name "Spring Carrot Harvest"[/green]
+        $ [dim]nextmv cloud switchback update --app-id hare-app --switchback-test-id carrot-feast \\
+            --name "Spring Carrot Harvest"[/dim]
 
     - Update the description of a switchback test.
-        $ [green]nextmv cloud switchback update --app-id hare-app --switchback-test-id bunny-hop-routes \\
-            --description "Optimizing hop paths through the meadow"[/green]
+        $ [dim]nextmv cloud switchback update --app-id hare-app --switchback-test-id bunny-hop-routes \\
+            --description "Optimizing hop paths through the meadow"[/dim]
 
     - Update both name and description and save the result.
-        $ [green]nextmv cloud switchback update --app-id hare-app --switchback-test-id lettuce-delivery \\
+        $ [dim]nextmv cloud switchback update --app-id hare-app --switchback-test-id lettuce-delivery \\
             --name "Warren Lettuce Express" --description "Fast lettuce delivery to all burrows" \\
-            --output updated-switchback-test.json[/green]
+            --output updated-switchback-test.json[/dim]
     """
 
     cloud_app = build_app(app_id=app_id, profile=profile)

nextmv/cli/cloud/upload/create.py

@@ -23,10 +23,10 @@ def create(
     [bold][underline]Examples[/underline][/bold]
 
     - Create an upload URL for application [magenta]hare-app[/magenta].
-        $ [green]nextmv cloud upload create --app-id hare-app[/green]
+        $ [dim]nextmv cloud upload create --app-id hare-app[/dim]
 
     - Create an upload URL for application [magenta]hare-app[/magenta] using profile [magenta]hare[/magenta].
-        $ [green]nextmv cloud upload create --app-id hare-app --profile hare[/green]
+        $ [dim]nextmv cloud upload create --app-id hare-app --profile hare[/dim]
     """
 
     cloud_app = build_app(app_id=app_id, profile=profile)

nextmv/cli/cloud/version/create.py

@@ -58,28 +58,27 @@ def create(
     """
     Create a new Nextmv Cloud application version.
 
-    Use the [code]--exist-ok[/code] flag to avoid errors when creating a
-    version with an ID that already exists. This is useful for scripts that
-    need to ensure a version exists without worrying about whether it was
-    created previously.
+    Use the --exist-ok flag to avoid errors when creating a version with an ID
+    that already exists. This is useful for scripts that need to ensure a
+    version exists without worrying about whether it was created previously.
 
     [bold][underline]Examples[/underline][/bold]
 
     - Create a version for application [magenta]hare-app[/magenta]. A random ID will be generated.
-        $ [green]nextmv cloud version create --app-id hare-app[/green]
+        $ [dim]nextmv cloud version create --app-id hare-app[/dim]
 
     - Create a version with a specific name.
-        $ [green]nextmv cloud version create --app-id hare-app --name "v1.0.0"[/green]
+        $ [dim]nextmv cloud version create --app-id hare-app --name "v1.0.0"[/dim]
 
     - Create a version with a specific ID.
-        $ [green]nextmv cloud version create --app-id hare-app --version-id v1[/green]
+        $ [dim]nextmv cloud version create --app-id hare-app --version-id v1[/dim]
 
     - Create a version with a name and description.
-        $ [green]nextmv cloud version create --app-id hare-app --name "v1.0.0" \\
-            --description "Initial release with routing optimization"[/green]
+        $ [dim]nextmv cloud version create --app-id hare-app --name "v1.0.0" \\
+            --description "Initial release with routing optimization"[/dim]
 
     - Create a version, or get it if it already exists.
-        $ [green]nextmv cloud version create --app-id hare-app --version-id v1 --exist-ok[/green]
+        $ [dim]nextmv cloud version create --app-id hare-app --version-id v1 --exist-ok[/dim]
     """
 
     cloud_app = build_app(app_id=app_id, profile=profile)

nextmv/cli/cloud/version/delete.py

@@ -5,9 +5,9 @@ This module defines the cloud version delete command for the Nextmv CLI.
 from typing import Annotated
 
 import typer
-from rich.prompt import Confirm
 
 from nextmv.cli.configuration.config import build_app
+from nextmv.cli.confirm import get_confirmation
 from nextmv.cli.message import info, success
 from nextmv.cli.options import AppIDOption, ProfileOption, VersionIDOption
 
@@ -32,23 +32,22 @@ def delete(
     """
     Deletes a Nextmv Cloud application version.
 
-    This action is permanent and cannot be undone. Use the [code]--yes[/code]
+    This action is permanent and cannot be undone. Use the --yes
     flag to skip the confirmation prompt.
 
     [bold][underline]Examples[/underline][/bold]
 
     - Delete the version with the ID [magenta]v1[/magenta] from application [magenta]hare-app[/magenta].
-        $ [green]nextmv cloud version delete --app-id hare-app --version-id v1[/green]
+        $ [dim]nextmv cloud version delete --app-id hare-app --version-id v1[/dim]
 
     - Delete the version without confirmation prompt.
-        $ [green]nextmv cloud version delete --app-id hare-app --version-id v1 --yes[/green]
+        $ [dim]nextmv cloud version delete --app-id hare-app --version-id v1 --yes[/dim]
     """
 
     if not yes:
-        confirm = Confirm.ask(
+        confirm = get_confirmation(
             f"Are you sure you want to delete version [magenta]{version_id}[/magenta] "
             f"from application [magenta]{app_id}[/magenta]? This action cannot be undone.",
-            default=False,
         )
 
         if not confirm:

nextmv/cli/cloud/version/exists.py

@@ -27,10 +27,10 @@ def exists(
     [bold][underline]Examples[/underline][/bold]
 
     - Check if the version with the ID [magenta]v1[/magenta] exists in application [magenta]hare-app[/magenta].
-        $ [green]nextmv cloud version exists --app-id hare-app --version-id v1[/green]
+        $ [dim]nextmv cloud version exists --app-id hare-app --version-id v1[/dim]
 
     - Check if the version exists using the profile named [magenta]hare[/magenta].
-        $ [green]nextmv cloud version exists --app-id hare-app --version-id v1 --profile hare[/green]
+        $ [dim]nextmv cloud version exists --app-id hare-app --version-id v1 --profile hare[/dim]
     """
 
     cloud_app = build_app(app_id=app_id, profile=profile)

nextmv/cli/cloud/version/get.py

@@ -39,11 +39,11 @@ def get(
     [bold][underline]Examples[/underline][/bold]
 
     - Get the version with the ID [magenta]v1[/magenta] from application [magenta]hare-app[/magenta].
-        $ [green]nextmv cloud version get --app-id hare-app --version-id v1[/green]
+        $ [dim]nextmv cloud version get --app-id hare-app --version-id v1[/dim]
 
     - Get the version with the ID [magenta]v1[/magenta] and save the information to a
       [magenta]version.json[/magenta] file.
-        $ [green]nextmv cloud version get --app-id hare-app --version-id v1 --output version.json[/green]
+        $ [dim]nextmv cloud version get --app-id hare-app --version-id v1 --output version.json[/dim]
     """
 
     cloud_app = build_app(app_id=app_id, profile=profile)

nextmv/cli/cloud/version/list.py

@@ -35,13 +35,13 @@ def list(
     [bold][underline]Examples[/underline][/bold]
 
     - List all versions of application [magenta]hare-app[/magenta].
-        $ [green]nextmv cloud version list --app-id hare-app[/green]
+        $ [dim]nextmv cloud version list --app-id hare-app[/dim]
 
     - List all versions using the profile named [magenta]hare[/magenta].
-        $ [green]nextmv cloud version list --app-id hare-app --profile hare[/green]
+        $ [dim]nextmv cloud version list --app-id hare-app --profile hare[/dim]
 
     - List all versions and save the information to a [magenta]versions.json[/magenta] file.
-        $ [green]nextmv cloud version list --app-id hare-app --output versions.json[/green]
+        $ [dim]nextmv cloud version list --app-id hare-app --output versions.json[/dim]
     """
 
     cloud_app = build_app(app_id=app_id, profile=profile)

nextmv/cli/cloud/version/update.py

@@ -54,23 +54,23 @@ def update(
     [bold][underline]Examples[/underline][/bold]
 
     - Update a version's name.
-        $ [green]nextmv cloud version update --app-id hare-app --version-id v1 --name "Version 1.0"[/green]
+        $ [dim]nextmv cloud version update --app-id hare-app --version-id v1 --name "Version 1.0"[/dim]
 
     - Update a version's description.
-        $ [green]nextmv cloud version update --app-id hare-app --version-id v1 \\
-            --description "Initial stable release"[/green]
+        $ [dim]nextmv cloud version update --app-id hare-app --version-id v1 \\
+            --description "Initial stable release"[/dim]
 
     - Update a version's name and description at once.
-        $ [green]nextmv cloud version update --app-id hare-app --version-id v1 \\
-            --name "Version 1.0" --description "Initial stable release"[/green]
+        $ [dim]nextmv cloud version update --app-id hare-app --version-id v1 \\
+            --name "Version 1.0" --description "Initial stable release"[/dim]
 
     - Update a version and save the updated information to a [magenta]updated_version.json[/magenta] file.
-        $ [green]nextmv cloud version update --app-id hare-app --version-id v1 \\
-            --name "Version 1.0" --output updated_version.json[/green]
+        $ [dim]nextmv cloud version update --app-id hare-app --version-id v1 \\
+            --name "Version 1.0" --output updated_version.json[/dim]
     """
 
     if name is None and description is None:
-        error("Provide at least one option to update: [code]--name[/code] or [code]--description[/code].")
+        error("Provide at least one option to update: --name or --description.")
 
     cloud_app = build_app(app_id=app_id, profile=profile)
     updated_version = cloud_app.update_version(

nextmv/cli/community/clone.py

@@ -53,35 +53,35 @@ def clone(
     Clone a community app locally.
 
     By default, the [magenta]latest[/magenta] version will be used. You can
-    specify a version with the [code]--version[/code] flag, and customize the
-    output directory with the [code]--directory[/code] flag. If you want to
-    list the available apps, use the [code]nextmv community list[/code] command.
+    specify a version with the --version flag, and customize the output
+    directory with the --directory flag. If you want to list the available
+    apps, use the [code]nextmv community list[/code] command.
 
     [bold][underline]Examples[/underline][/bold]
 
     - Clone the [magenta]go-nextroute[/magenta] community app (under the
       [magenta]"go-nextroute"[/magenta] directory), using the [magenta]latest[/magenta] version.
-        $ [green]nextmv community clone --app go-nextroute[/green]
+        $ [dim]nextmv community clone --app go-nextroute[/dim]
 
     - Clone the [magenta]go-nextroute[/magenta] community app under the
       [magenta]"~/sample/my_app"[/magenta] directory, using the [magenta]latest[/magenta] version.
-        $ [green]nextmv community clone --app go-nextroute --directory ~/sample/my_app[/green]
+        $ [dim]nextmv community clone --app go-nextroute --directory ~/sample/my_app[/dim]
 
     - Clone the [magenta]go-nextroute[/magenta] community app (under the
       [magenta]"go-nextroute"[/magenta] directory), using version [magenta]v1.2.0[/magenta].
-        $ [green]nextmv community clone --app go-nextroute --version v1.2.0[/green]
+        $ [dim]nextmv community clone --app go-nextroute --version v1.2.0[/dim]
 
     - Clone the [magenta]go-nextroute[/magenta] community app (under the
       [magenta]"go-nextroute"[/magenta] directory), using the [magenta]latest[/magenta] version
       and a profile named [magenta]hare[/magenta].
-        $ [green]nextmv community clone --app go-nextroute --profile hare[/green]
+        $ [dim]nextmv community clone --app go-nextroute --profile hare[/dim]
     """
 
     manifest = download_manifest(profile=profile)
     app_obj = find_app(manifest, app)
 
     if version is not None and version == "":
-        error("The [code]--version[/code] flag cannot be an empty string.")
+        error("The --version flag cannot be an empty string.")
 
     if not app_has_version(app_obj, version):
         # We don't use error() here to allow printing something before exiting.
@@ -97,8 +97,10 @@ def clone(
     if version == LATEST_VERSION:
         version = app_obj.get("latest_app_version")
 
-    destination = directory
-    if directory is None or directory == "":
+    # Clean and normalize directory path in an OS-independent way
+    if directory is not None and directory != "":
+        destination = os.path.normpath(directory)
+    else:
         destination = app
 
     full_destination = get_valid_path(destination, os.stat)

nextmv/cli/community/list.py

@@ -37,30 +37,30 @@ def list(
     """
     List the available community apps
 
-    Use the [code]--app[/code] flag to list that app's versions. Use the
-    [code]--flat[/code] flag to flatten the list of names/versions. If you
-    want to clone a community app locally, use the [code]nextmv community clone[/code] command.
+    Use the --app flag to list that app's versions. Use the --flat flag to
+    flatten the list of names/versions. If you want to clone a community app
+    locally, use the [code]nextmv community clone[/code] command.
 
     [bold][underline]Examples[/underline][/bold]
 
     - List the available community apps.
-        $ [green]nextmv community list[/green]
+        $ [dim]nextmv community list[/dim]
 
     - List the available versions of the [magenta]go-nextroute[/magenta] community app.
-        $ [green]nextmv community list --app go-nextroute[/green]
+        $ [dim]nextmv community list --app go-nextroute[/dim]
 
     - List the names of the available community apps as a flat list.
-        $ [green]nextmv community list --flat[/green]
+        $ [dim]nextmv community list --flat[/dim]
 
     - List the available versions of the [magenta]go-nextroute[/magenta] community app as a flat list.
-        $ [green]nextmv community list --app go-nextroute --flat[/green]
+        $ [dim]nextmv community list --app go-nextroute --flat[/dim]
 
     - List the available community apps using a profile named [magenta]hare[/magenta].
-        $ [green]nextmv community list --profile hare[/green]
+        $ [dim]nextmv community list --profile hare[/dim]
     """
 
     if app is not None and app == "":
-        error("The [code]--app[/code] flag cannot be an empty string.")
+        error("The --app flag cannot be an empty string.")
 
     manifest = download_manifest(profile=profile)
     if flat and app is None: