reorder cli commands navigations are now into a nav sub group

browser_cli/cli.py

@@ -1,4 +1,4 @@
-#!/usr/bin/env python3
+#!/usr/bin/env -S uv run
 """
 browser-cli — Control your running browser from the terminal.
 """
@@ -10,7 +10,7 @@ import stat
 from pathlib import Path
 from rich.console import Console
 
-from browser_cli.commands.navigate import cmd_open, cmd_reload, cmd_hard_reload, cmd_back, cmd_forward, cmd_focus
+from browser_cli.commands.navigate import nav_group
 from browser_cli.commands.tabs import tabs_group
 from browser_cli.commands.groups import group_group
 from browser_cli.commands.windows import windows_group
@@ -44,15 +44,8 @@ def main():
     """Control your running browser from the terminal via a Chrome extension."""
 
 
-# ── Top-level navigation commands ─────────────────────────────────────────────
-main.add_command(cmd_open, name="open")
-main.add_command(cmd_reload, name="reload")
-main.add_command(cmd_hard_reload, name="hard-reload")
-main.add_command(cmd_back, name="back")
-main.add_command(cmd_forward, name="forward")
-main.add_command(cmd_focus, name="focus")
-
 # ── Sub-command groups ─────────────────────────────────────────────────────────
+main.add_command(nav_group)
 main.add_command(tabs_group)
 main.add_command(group_group)
 main.add_command(windows_group)

browser_cli/commands/navigate.py

@@ -16,14 +16,19 @@ def _handle(command, args):
         raise SystemExit(1)
 
 
-@click.command("open")
+@click.group("nav")
+def nav_group():
+    """Navigate — open URLs, reload, go back/forward, focus tabs."""
+
+
+@nav_group.command("open")
 @click.argument("url")
 @click.option("--bg", is_flag=True, help="Open in background (no focus)")
 @click.option("--window", "window_name", default=None, help="Open in named window")
 @click.option("--group", "group_name", default=None, help="Open directly into a tab group (name or ID)")
 def cmd_open(url, bg, window_name, group_name):
     """Open URL in a new tab."""
-    result = _handle("navigate.open", {"url": url, "background": bg, "window": window_name, "group": group_name})
+    _handle("navigate.open", {"url": url, "background": bg, "window": window_name, "group": group_name})
     suffix = ""
     if group_name:
         suffix = f" in group '{group_name}'"
@@ -32,7 +37,7 @@ def cmd_open(url, bg, window_name, group_name):
     console.print(f"[green]Opened:[/green] {url}{suffix}")
 
 
-@click.command("reload")
+@nav_group.command("reload")
 @click.argument("tab_id", type=int, required=False)
 def cmd_reload(tab_id):
     """Reload the active (or specified) tab."""
@@ -40,7 +45,7 @@ def cmd_reload(tab_id):
     console.print("[green]Reloaded[/green]")
 
 
-@click.command("hard-reload")
+@nav_group.command("hard-reload")
 @click.argument("tab_id", type=int, required=False)
 def cmd_hard_reload(tab_id):
     """Hard reload (bypass cache) the active (or specified) tab."""
@@ -48,7 +53,7 @@ def cmd_hard_reload(tab_id):
     console.print("[green]Hard reloaded[/green]")
 
 
-@click.command("back")
+@nav_group.command("back")
 @click.argument("tab_id", type=int, required=False)
 def cmd_back(tab_id):
     """Navigate back in the active (or specified) tab."""
@@ -56,7 +61,7 @@ def cmd_back(tab_id):
     console.print("[green]Navigated back[/green]")
 
 
-@click.command("forward")
+@nav_group.command("forward")
 @click.argument("tab_id", type=int, required=False)
 def cmd_forward(tab_id):
     """Navigate forward in the active (or specified) tab."""
@@ -64,7 +69,7 @@ def cmd_forward(tab_id):
     console.print("[green]Navigated forward[/green]")
 
 
-@click.command("focus")
+@nav_group.command("focus")
 @click.argument("pattern")
 def cmd_focus(pattern):
     """Jump to the first tab whose URL matches PATTERN."""