feat(cli): v1.3.0 — polish consistency, help, and description

- Bump version to 1.3.0
- Better CLI description: 'Build and deploy computer vision models...'
- Hide noisy aliases from --help (login, whoami, upload, import) — keep download
- Hide --install-completion/--show-completion (we have 'completion' subcommand)
- Add 'roboflow help' as alias for --help
- workspace get defaults to current workspace when no ID given
- Commands alphabetized in help output

374 tests pass, all linting clean.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: yeldarby

roboflow/__init__.py

@@ -15,7 +15,7 @@
 from roboflow.models import CLIPModel, GazeModel  # noqa: F401
 from roboflow.util.general import write_line
 
-__version__ = "1.2.16"
+__version__ = "1.3.0"
 
 
 def check_key(api_key, model, notebook, num_retries=0):

roboflow/cli/__init__.py

@@ -20,9 +20,15 @@
 
 app = typer.Typer(
     name="roboflow",
-    help="Roboflow CLI: computer vision at your fingertips",
+    help=(
+        "Build and deploy computer vision models with Roboflow. "
+        "Manage datasets, train models, run inference, and deploy "
+        "workflows \u2014 from the command line or via structured JSON for AI agents."
+    ),
     no_args_is_help=True,
     pretty_exceptions_enable=False,  # We handle errors ourselves via output_error
+    rich_markup_mode="rich",
+    add_completion=False,  # We have our own 'completion' subcommand
 )
 
 
@@ -92,6 +98,7 @@ def _root_callback(
 from roboflow.cli.handlers.workflow import workflow_app  # noqa: E402
 from roboflow.cli.handlers.workspace import workspace_app  # noqa: E402
 
+# Register command groups (alphabetical order)
 app.add_typer(annotation_app, name="annotation")
 app.add_typer(auth_app, name="auth")
 app.add_typer(batch_app, name="batch")
@@ -112,11 +119,20 @@ def _root_callback(
 infer_command(app)
 search_command(app)
 
-# Backwards-compat aliases (loaded last)
+# "roboflow download" — visible shorthand (common enough to show)
+# "roboflow help" — alias for --help
 from roboflow.cli.handlers._aliases import register_aliases  # noqa: E402
 
 register_aliases(app)
 
+
+# "roboflow help" command
+@app.command("help", hidden=True)
+def help_command(ctx: typer.Context) -> None:
+    """Show help information."""
+    print(ctx.parent.get_help() if ctx.parent else ctx.get_help())  # noqa: T201
+
+
 # ---------------------------------------------------------------------------
 # Backwards-compat: build_parser returns None (argparse is gone)
 # ---------------------------------------------------------------------------

roboflow/cli/handlers/_aliases.py

@@ -19,9 +19,9 @@
 def register_aliases(app: typer.Typer) -> None:
     """Register top-level aliases for common commands."""
 
-    # --- roboflow login (visible alias for auth login) ---
+    # --- roboflow login (hidden alias for auth login) ---
 
-    @app.command("login")
+    @app.command("login", hidden=True)
     def login_alias(
         ctx: typer.Context,
         login_api_key: Annotated[
@@ -35,19 +35,19 @@ def login_alias(
         args = ctx_to_args(ctx, login_api_key=login_api_key, force=force)
         _login(args)
 
-    # --- roboflow whoami (visible alias for auth status) ---
+    # --- roboflow whoami (hidden alias for auth status) ---
 
-    @app.command("whoami")
+    @app.command("whoami", hidden=True)
     def whoami_alias(ctx: typer.Context) -> None:
         """Show current user (alias for 'auth status')."""
         from roboflow.cli.handlers.auth import _status
 
         args = ctx_to_args(ctx)
         _status(args)
 
-    # --- roboflow upload (visible alias for image upload) ---
+    # --- roboflow upload (hidden alias for image upload) ---
 
-    @app.command("upload")
+    @app.command("upload", hidden=True)
     def upload_alias(
         ctx: typer.Context,
         path: Annotated[str, typer.Argument(help="Path to image file or directory")],
@@ -81,9 +81,9 @@ def upload_alias(
         )
         _handle_upload(args)
 
-    # --- roboflow import (visible alias for image upload with directory) ---
+    # --- roboflow import (hidden alias for image upload with directory) ---
 
-    @app.command("import")
+    @app.command("import", hidden=True)
     def import_alias(
         ctx: typer.Context,
         path: Annotated[str, typer.Argument(metavar="folder", help="Path to dataset folder")],

roboflow/cli/handlers/workspace.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Annotated
+from typing import Annotated, Optional
 
 import typer
 
@@ -21,9 +21,18 @@ def list_workspaces(ctx: typer.Context) -> None:
 @workspace_app.command("get")
 def get_workspace(
     ctx: typer.Context,
-    workspace_id: Annotated[str, typer.Argument(help="Workspace URL or ID")],
+    workspace_id: Annotated[
+        Optional[str], typer.Argument(help="Workspace URL or ID (defaults to current workspace)")
+    ] = None,
 ) -> None:
     """Get workspace details."""
+    # Default to current workspace if not specified
+    if not workspace_id:
+        from roboflow.cli._resolver import resolve_default_workspace
+
+        workspace_id = (ctx.obj or {}).get("workspace") or resolve_default_workspace(
+            api_key=(ctx.obj or {}).get("api_key")
+        )
     args = ctx_to_args(ctx, workspace_id=workspace_id)
     _get_workspace(args)