small cli fix

Author: networmix

docs/reference/api-full.md

@@ -12,7 +12,7 @@ Quick links:
 - [CLI Reference](cli.md)
 - [DSL Reference](dsl.md)
 
-Generated from source code on: August 09, 2025 at 01:51 UTC
+Generated from source code on: August 09, 2025 at 02:14 UTC
 
 Modules auto-discovered: 59
 

docs/reference/cli.md

@@ -27,8 +27,8 @@ The CLI provides three primary commands:
 
 **Global options** (must be placed before the command):
 
-- `--verbose`, `-v`: Enable verbose (DEBUG) logging
-- `--quiet`, `-q`: Enable quiet mode (WARNING+ only)
+- `--verbose`, `-v`: Enable debug logging
+- `--quiet`: Suppress console output (logs only)
 
 ### Quick Start
 

ngraph/cli.py

@@ -528,17 +528,26 @@ def main(argv: Optional[List[str]] = None) -> None:
         argv: Optional list of command-line arguments. If ``None``, ``sys.argv``
             is used.
     """
-    parser = argparse.ArgumentParser(prog="ngraph")
+    parser = argparse.ArgumentParser(
+        prog="ngraph",
+        description="Run and analyze network scenarios.",
+    )
 
     # Global options
     parser.add_argument(
-        "--verbose", "-v", action="store_true", help="Enable verbose (DEBUG) logging"
+        "--verbose", "-v", action="store_true", help="Enable debug logging"
     )
     parser.add_argument(
-        "--quiet", "-q", action="store_true", help="Enable quiet mode (WARNING+ only)"
+        "--quiet", action="store_true", help="Suppress console output (logs only)"
     )
 
-    subparsers = parser.add_subparsers(dest="command", required=True)
+    subparsers = parser.add_subparsers(
+        dest="command",
+        required=True,
+        title="Available commands",
+        metavar="{run,inspect,report}",
+        help="Available commands",
+    )
 
     # Run command
     run_parser = subparsers.add_parser("run", help="Run a scenario")
@@ -614,6 +623,11 @@ def main(argv: Optional[List[str]] = None) -> None:
         help="Include code cells in HTML output (default: report without code)",
     )
 
+    # If no arguments are provided, show help and exit cleanly
+    if not argv:
+        parser.print_help()
+        raise SystemExit(0)
+
     args = parser.parse_args(argv)
 
     # Configure logging based on arguments