From 56bc3c6e45e0c5e43665667cceb8e6161c70e974 Mon Sep 17 00:00:00 2001
From: UncleCode <unclecode@kidocode.com>
Date: Tue, 4 Mar 2025 20:28:16 +0800
Subject: [PATCH] refactor(cli): improve CLI default command handling

Make 'crawl' the default command when no command is specified.
This improves user experience by allowing direct URL input without
explicitly specifying the 'crawl' command.

Also removes unnecessary blank lines in example code for better readability.
---
 crawl4ai/cli.py                    | 10 ++++++++--
 docs/examples/deepcrawl_example.py |  6 ------
 pyproject.toml                     |  2 +-
 3 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/crawl4ai/cli.py b/crawl4ai/cli.py
index b32ab4cc..8141eb7d 100644
--- a/crawl4ai/cli.py
+++ b/crawl4ai/cli.py
@@ -712,7 +712,7 @@ def profiles_cmd():
     # Run interactive profile manager
     anyio.run(manage_profiles)
 
-@cli.command()
+@cli.command(name="")
 @click.argument("url", required=False)
 @click.option("--example", is_flag=True, help="Show usage examples")
 @click.option("--browser-config", "-B", type=click.Path(exists=True), help="Browser config file (YAML/JSON)")
@@ -772,5 +772,11 @@ def default(url: str, example: bool, browser_config: str, crawler_config: str, f
         profile=profile
     )
 
+def main():
+    import sys
+    if len(sys.argv) < 2 or sys.argv[1] not in cli.commands:
+        sys.argv.insert(1, "crawl")
+    cli()
+
 if __name__ == "__main__":
-    cli()
\ No newline at end of file
+    main()
\ No newline at end of file
diff --git a/docs/examples/deepcrawl_example.py b/docs/examples/deepcrawl_example.py
index 6b11179c..14a9f69d 100644
--- a/docs/examples/deepcrawl_example.py
+++ b/docs/examples/deepcrawl_example.py
@@ -65,7 +65,6 @@ async def basic_deep_crawl():
             f"\n✅ Performance: {len(results)} pages in {time.perf_counter() - start_time:.2f} seconds"
         )
 
-
 # 2️⃣ Stream vs. Non-Stream Execution
 async def stream_vs_nonstream():
     """
@@ -127,7 +126,6 @@ async def stream_vs_nonstream():
         print(f"  ✅ All results: {time.perf_counter() - start_time:.2f} seconds")
         print("\n🔍 Key Takeaway: Streaming allows processing results immediately")
 
-
 # 3️⃣ Introduce Filters & Scorers
 async def filters_and_scorers():
     """
@@ -236,7 +234,6 @@ async def filters_and_scorers():
         print(f"  ✅ Crawler prioritized {len(results)} pages by relevance score")
         print("  🔍 Note: BestFirstCrawlingStrategy visits highest-scoring pages first")
 
-
 # 4️⃣ Wrap-Up and Key Takeaways
 async def wrap_up():
     """
@@ -307,7 +304,6 @@ async def wrap_up():
     for depth, count in sorted(depth_counts.items()):
         print(f"  Depth {depth}: {count} pages")
 
-
 # 5️⃣ Advanced Filters
 async def advanced_filters():
     """
@@ -371,7 +367,6 @@ async def advanced_filters():
             relevance_score = result.metadata.get("relevance_score", 0)
             print(f"  → Score: {relevance_score:.2f} | {result.url}")
 
-
 # Main function to run the entire tutorial
 async def max_pages_and_thresholds():
     """
@@ -497,7 +492,6 @@ async def run_tutorial():
     print("You now have a comprehensive understanding of deep crawling with Crawl4AI.")
     print("For more information, check out https://docs.crawl4ai.com")
 
-
 # Execute the tutorial when run directly
 if __name__ == "__main__":
     asyncio.run(run_tutorial())
\ No newline at end of file
diff --git a/pyproject.toml b/pyproject.toml
index 4143a646..b4fb392f 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -78,7 +78,7 @@ crawl4ai-download-models = "crawl4ai.model_loader:main"
 crawl4ai-migrate = "crawl4ai.migrations:main"
 crawl4ai-setup = "crawl4ai.install:post_install"
 crawl4ai-doctor = "crawl4ai.install:doctor"
-crwl = "crawl4ai.cli:cli"
+crwl = "crawl4ai.cli:main"
 
 [tool.setuptools]
 packages = {find = {where = ["."], include = ["crawl4ai*"]}}