feat(cli): add model infer, unify image search, fix description truncation

1. Add 'model infer' command that delegates to the existing infer logic.
   Now inference lives in the noun-verb hierarchy where users expect it.

2. Make 'image search' project-optional: without -p searches the whole
   workspace (using the workspace-level RoboQL search). With -p searches
   within a specific project. Also adds --export for dataset export.
   This unifies the old 'search' and 'image search' into one command.

3. Fix help text truncation by using cmd.help (full docstring first line)
   instead of short_help which Click caps at ~45 chars.

Hidden aliases (roboflow infer, roboflow search, roboflow download) all
still work — they're just not shown in --help.

374 tests pass, all linting clean.

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

Author: yeldarby

roboflow/cli/__init__.py

@@ -110,8 +110,10 @@ def _walk(group: Any, prefix: str = "") -> None:
             if hasattr(cmd, "list_commands") and cmd.list_commands(None):
                 _walk(cmd, full)
             else:
-                # Use the full short_help (not truncated get_short_help_str)
-                help_text = getattr(cmd, "short_help", None) or cmd.get_short_help_str() or ""
+                # Use the full help text: try help attr, then short_help, then docstring
+                help_text = getattr(cmd, "help", None) or getattr(cmd, "short_help", None) or ""
+                # Take only the first line/sentence
+                help_text = help_text.split("\n")[0].strip()
                 commands.append((full, help_text))
 
     _walk(click_app)

roboflow/cli/handlers/image.py

@@ -62,14 +62,71 @@ def get_image(
 @image_app.command("search")
 def search_images(
     ctx: typer.Context,
-    query: Annotated[str, typer.Argument(help="RoboQL search query")],
-    project: Annotated[str, typer.Option("-p", "--project", help="Project ID (used in query filter)")],
+    query: Annotated[str, typer.Argument(help="RoboQL search query (e.g. 'tag:review' or '*')")],
+    project: Annotated[
+        Optional[str], typer.Option("-p", "--project", help="Project ID (omit to search entire workspace)")
+    ] = None,
     limit: Annotated[int, typer.Option(help="Number of results")] = 50,
     cursor: Annotated[Optional[str], typer.Option(help="Continuation token for pagination")] = None,
+    export: Annotated[bool, typer.Option("--export", help="Export search results as a dataset")] = False,
+    format: Annotated[str, typer.Option("-f", "--format", help="Annotation format for export")] = "coco",
+    location: Annotated[Optional[str], typer.Option("-l", "--location", help="Local directory for export")] = None,
+    dataset: Annotated[
+        Optional[str], typer.Option("-d", "--dataset", help="Limit export to a specific dataset")
+    ] = None,
+    annotation_group: Annotated[
+        Optional[str], typer.Option("-g", "--annotation-group", help="Annotation group")
+    ] = None,
+    name: Annotated[Optional[str], typer.Option(help="Optional name for the export")] = None,
+    no_extract: Annotated[bool, typer.Option("--no-extract", help="Keep zip file, skip extraction")] = False,
 ) -> None:
-    """Search images in workspace."""
-    args = ctx_to_args(ctx, query=query, project=project, limit=limit, cursor=cursor)
-    _handle_search(args)
+    """Search images in workspace or project.
+
+    Without -p/--project, searches across the entire workspace using RoboQL.
+    With -p/--project, searches within a specific project.
+    Use --export to download matching results as a dataset.
+    """
+    if project:
+        # Project-scoped search (legacy behavior)
+        args = ctx_to_args(ctx, query=query, project=project, limit=limit, cursor=cursor)
+        _handle_search(args)
+    elif export:
+        # Workspace-level export
+        from roboflow.cli.handlers.search import _search
+
+        args = ctx_to_args(
+            ctx,
+            query=query,
+            limit=limit,
+            cursor=cursor,
+            export=True,
+            format=format,
+            location=location,
+            dataset=dataset,
+            annotation_group=annotation_group,
+            name=name,
+            no_extract=no_extract,
+        )
+        _search(args)
+    else:
+        # Workspace-level search
+        from roboflow.cli.handlers.search import _search
+
+        args = ctx_to_args(
+            ctx,
+            query=query,
+            limit=limit,
+            cursor=cursor,
+            export=False,
+            format=format,
+            location=location,
+            dataset=dataset,
+            annotation_group=annotation_group,
+            name=name,
+            no_extract=no_extract,
+            fields=None,
+        )
+        _search(args)
 
 
 @image_app.command("tag")

roboflow/cli/handlers/model.py

@@ -31,6 +31,25 @@ def get_model(
     _get_model(args)
 
 
+@model_app.command("infer")
+def model_infer(
+    ctx: typer.Context,
+    file: Annotated[str, typer.Argument(help="Path to an image file")],
+    model: Annotated[str, typer.Option("-m", "--model", help="Model ID (project/version, e.g. my-project/3)")],
+    confidence: Annotated[float, typer.Option("-c", "--confidence", help="Confidence threshold 0.0-1.0")] = 0.5,
+    overlap: Annotated[float, typer.Option("-o", "--overlap", help="Overlap/NMS threshold 0.0-1.0")] = 0.5,
+    type: Annotated[
+        Optional[str],
+        typer.Option("-t", "--type", help="Model type (auto-detected if not specified)"),
+    ] = None,
+) -> None:
+    """Run inference on an image using a trained model."""
+    from roboflow.cli.handlers.infer import _infer
+
+    args = ctx_to_args(ctx, file=file, model=model, confidence=confidence, overlap=overlap, type=type)
+    _infer(args)
+
+
 @model_app.command("upload")
 def upload_model(
     ctx: typer.Context,