usecli 0.1.29__tar.gz → 0.1.31__tar.gz

{usecli-0.1.29 → usecli-0.1.31}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: usecli
-Version: 0.1.29
+Version: 0.1.31
 Summary: A powerful Python CLI framework for building beautiful, developer-friendly command-line tools.
 Author: Edward Boswell
 Author-email: Edward Boswell <thememium@gmail.com>
@@ -77,12 +77,18 @@ useCli A powerful Python CLI framework for building beautiful, developer-friendl
 
 ## Quick Start
 
-### Install usecli:
+### Install usecli with uv (recommended)
 
 ```sh
 uv add usecli
 ```
 
+### Install with pip (alternative)
+
+```sh
+pip install usecli
+```
+
 ### Initialize
 
 ```sh

{usecli-0.1.29 → usecli-0.1.31}/README.md

@@ -48,12 +48,18 @@ useCli A powerful Python CLI framework for building beautiful, developer-friendl
 
 ## Quick Start
 
-### Install usecli:
+### Install usecli with uv (recommended)
 
 ```sh
 uv add usecli
 ```
 
+### Install with pip (alternative)
+
+```sh
+pip install usecli
+```
+
 ### Initialize
 
 ```sh

{usecli-0.1.29 → usecli-0.1.31}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "usecli"
-version = "0.1.29"
+version = "0.1.31"
 description = "A powerful Python CLI framework for building beautiful, developer-friendly command-line tools."
 readme = "README.md"
 authors = [{ name = "Edward Boswell", email = "thememium@gmail.com" }]

{usecli-0.1.29 → usecli-0.1.31}/src/usecli/__init__.py

@@ -192,7 +192,7 @@ def run_app(
     ),
     help: bool = typer.Option(None, "--help", "-h", is_eager=True),
     interactive: bool = typer.Option(
-        False, "--interactive", "-i", help="Run in interactive mode", is_eager=True
+        False, "--interactive", "-i", help="Run in interactive mode.", is_eager=True
     ),
 ) -> None:
     """Main callback for the CLI application.

{usecli-0.1.29 → usecli-0.1.31}/src/usecli/cli/core/base_command.py

@@ -12,6 +12,7 @@ from rich.console import Console
 from typer.core import TyperCommand
 
 from usecli.cli.config.colors import COLOR
+from usecli.cli.core.ui.title import get_script_command_name
 
 if TYPE_CHECKING:
     from click.core import Context as ClickContext
@@ -88,7 +89,7 @@ class NestedCommandRegistry:
                 False,
                 "--interactive",
                 "-i",
-                help="Run in interactive mode",
+                help="Run in interactive mode.",
             ),
         ) -> None:
             """Callback for the command group."""
@@ -181,7 +182,7 @@ class CustomHelpCommand(TyperCommand):
                 Option(
                     ["--interactive", "-i"],
                     is_flag=True,
-                    help="Run in interactive mode",
+                    help="Run in interactive mode.",
                 )
             )
 
@@ -223,7 +224,8 @@ class CustomHelpCommand(TyperCommand):
         ]
 
         arg_usage = " ".join(rf"\[{name.upper()}]" for name in argument_names)
-        usage = f"  [bold {COLOR.WARNING}]usecli {self.name}[/bold {COLOR.WARNING}] [bold {COLOR.PRIMARY}][OPTIONS]{f' {arg_usage}' if arg_usage else ''}[/bold {COLOR.PRIMARY}]"
+        command_name = get_script_command_name(default="usecli") or "usecli"
+        usage = f"  [bold {COLOR.WARNING}]{command_name} {self.name}[/bold {COLOR.WARNING}] [bold {COLOR.PRIMARY}][OPTIONS]{f' {arg_usage}' if arg_usage else ''}[/bold {COLOR.PRIMARY}]"
 
         console.print()
         console.print(f"[bold {COLOR.SECONDARY}]Usage:[/bold {COLOR.SECONDARY}]")
@@ -312,6 +314,9 @@ class BaseCommand(ABC):
         """
         pass
 
+    def aliases(self) -> list[str]:
+        return []
+
     def visible(self) -> bool:
         return True
 
@@ -321,6 +326,7 @@ class BaseCommand(ABC):
 
         signature = self.signature()
         signature_parts = signature.split()
+        aliases = self.aliases()
 
         # Check if this is a space-separated nested command signature (e.g., "spec show")
         # vs a command with argument placeholders (e.g., "test-cmd <name>")
@@ -338,21 +344,98 @@ class BaseCommand(ABC):
             registry = NestedCommandRegistry()
             group_app = registry.get_or_create_group(self.app, group_name)
 
-            cmd_decorator = group_app.command(
+            normalized_aliases = self._normalize_aliases(
+                primary_name=command_name,
+                aliases=aliases,
+                group_name=group_name,
+            )
+            self._register_with_aliases(
+                app=group_app,
                 name=command_name,
-                help=self.description(),
-                cls=CustomHelpCommand,
+                description=self.description(),
+                aliases=normalized_aliases,
             )
-            cmd_decorator(self.handle)
         else:
             # Single-level command (e.g., "help", "init", "config:set", "make:command")
             name = signature_parts[0]
-            cmd_decorator = self.app.command(
+            normalized_aliases = self._normalize_aliases(
+                primary_name=name,
+                aliases=aliases,
+                group_name=None,
+            )
+            self._register_with_aliases(
+                app=self.app,
                 name=name,
-                help=self.description(),
+                description=self.description(),
+                aliases=normalized_aliases,
+            )
+
+    def _register_with_aliases(
+        self,
+        app: typer.Typer,
+        name: str,
+        description: str,
+        aliases: list[str],
+    ) -> None:
+        cmd_decorator = app.command(
+            name=name,
+            help=description,
+            cls=CustomHelpCommand,
+        )
+        cmd_decorator(self.handle)
+
+        if not aliases:
+            return
+
+        alias_registry = self._get_alias_registry(app)
+        alias_registry.setdefault(name, [])
+        for alias in aliases:
+            if alias == name or alias in alias_registry[name]:
+                continue
+            alias_registry[name].append(alias)
+            alias_decorator = app.command(
+                name=alias,
+                help=description,
                 cls=CustomHelpCommand,
             )
-            cmd_decorator(self.handle)
+            alias_decorator(self.handle)
+
+    def _get_alias_registry(self, app: typer.Typer) -> dict[str, list[str]]:
+        if not hasattr(app, "_usecli_aliases"):
+            setattr(app, "_usecli_aliases", {})
+        registry = getattr(app, "_usecli_aliases")
+        if not isinstance(registry, dict):
+            registry = {}
+            setattr(app, "_usecli_aliases", registry)
+        return registry
+
+    def _normalize_aliases(
+        self,
+        primary_name: str,
+        aliases: list[str],
+        group_name: str | None,
+    ) -> list[str]:
+        normalized: list[str] = []
+        for alias in aliases:
+            alias_parts = alias.split()
+            if group_name:
+                if len(alias_parts) == 2 and alias_parts[0] == group_name:
+                    alias_name = alias_parts[1]
+                elif len(alias_parts) == 1:
+                    alias_name = alias_parts[0]
+                else:
+                    continue
+                if not self._is_valid_subcommand_name(alias_name):
+                    continue
+            else:
+                if len(alias_parts) != 1:
+                    continue
+                alias_name = alias_parts[0]
+
+            if alias_name == primary_name or alias_name in normalized:
+                continue
+            normalized.append(alias_name)
+        return normalized
 
     def _is_valid_subcommand_name(self, name: str) -> bool:
         """Check if a string is a valid subcommand name (not an argument placeholder).

{usecli-0.1.29 → usecli-0.1.31}/src/usecli/cli/core/exceptions/usage.py

@@ -5,14 +5,29 @@ from __future__ import annotations
 import sys
 from typing import IO
 
+from click.core import Context as ClickContext
 from click.exceptions import BadParameter, UsageError
 from rich.console import Console
 
 from usecli.cli.config.colors import COLOR
+from usecli.cli.core.ui.title import get_script_command_name
 
 console = Console(stderr=True)
 
 
+def _get_help_text_with_command_name(ctx: ClickContext) -> str:
+    command_name = get_script_command_name(default=getattr(ctx, "info_name", None))
+    if not command_name:
+        return ctx.get_help()
+
+    original_info_name = getattr(ctx, "info_name", None)
+    try:
+        ctx.info_name = command_name
+        return ctx.get_help()
+    finally:
+        ctx.info_name = original_info_name
+
+
 class UsecliUsageError(UsageError):
     """Usage error with styled output and full command help.
 
@@ -35,7 +50,7 @@ class UsecliUsageError(UsageError):
 
         if self.ctx:
             console.print()
-            help_text = self.ctx.get_help()
+            help_text = _get_help_text_with_command_name(self.ctx)
             console.print(help_text)
 
 
@@ -64,5 +79,5 @@ class UsecliBadParameter(BadParameter):
         console.print(f"{error_prefix} {error_msg}")
 
         if self.ctx:
-            help_text = self.ctx.get_help()
+            help_text = _get_help_text_with_command_name(self.ctx)
             console.print(help_text)

usecli-0.1.31/src/usecli/cli/core/ui/list.py

@@ -0,0 +1,336 @@
+"""Command listing utilities for usecli CLI."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, TypedDict
+
+import click
+import typer
+from rich.console import Console
+
+from usecli.cli.config.colors import COLOR
+from usecli.cli.core.ui.title import (
+    get_project_name,
+    get_script_command_name,
+    print_title,
+)
+
+if TYPE_CHECKING:
+    pass
+
+console = Console()
+
+SPACER_LENGTH = 6
+
+
+class CommandEntry(TypedDict):
+    name: str
+    display_name: str
+    help: str
+    aliases: list[str]
+
+
+class CommandMeta(TypedDict):
+    help: str
+    aliases: list[str]
+
+
+def list_commands(app: typer.Typer, prefix_filter: str | None = None) -> None:
+    """List all available commands with optional filtering.
+
+    Displays commands in a formatted list with sections for grouped commands
+    (those with colons in their names).
+
+    Args:
+        app: The Typer application instance.
+        prefix_filter: Optional prefix to filter commands by name.
+    """
+    project_name = get_project_name()
+    print_title(title=project_name)
+
+    click_group = typer.main.get_command(app)
+
+    alias_registry = _get_alias_registry(app)
+    alias_to_primary = _build_alias_to_primary(alias_registry)
+
+    command_name = get_script_command_name(default="usecli")
+
+    commands_by_name: dict[str, CommandMeta] = {}
+    for command in app.registered_commands:
+        callback = command.callback
+        name = command.name or (
+            getattr(callback, "__name__", "unknown") if callback else "unknown"
+        )
+        if name in alias_to_primary and alias_to_primary[name] != name:
+            continue
+        help_text = command.help or ""
+        if name not in commands_by_name or (
+            not commands_by_name[name]["help"] and help_text
+        ):
+            commands_by_name[name] = {
+                "help": help_text,
+                "aliases": alias_registry.get(name, list[str]()),
+            }
+
+    commands: list[CommandEntry] = []
+    for name in commands_by_name:
+        aliases = commands_by_name[name]["aliases"]
+        command_entry: CommandEntry = {
+            "name": name,
+            "display_name": _format_display_name(name, aliases),
+            "help": commands_by_name[name]["help"],
+            "aliases": aliases,
+        }
+        commands.append(command_entry)
+    commands.sort(key=lambda x: x["name"])
+
+    if prefix_filter:
+        filtered = [
+            c
+            for c in commands
+            if c["name"].startswith(prefix_filter)
+            or any(alias.startswith(prefix_filter) for alias in c["aliases"])
+        ]
+        if not filtered:
+            console.print(f"  [dim]No commands found for '{prefix_filter}'[/dim]")
+            console.print()
+            return
+        commands = filtered
+
+    groups: dict[str, str] = {}
+    if isinstance(click_group, click.Group):
+        for cmd_name, cmd_obj in click_group.commands.items():
+            if isinstance(cmd_obj, click.Group):
+                groups[cmd_name] = (
+                    getattr(cmd_obj, "help", f"Commands for {cmd_name}")
+                    or f"Commands for {cmd_name}"
+                )
+
+    option_flags = []
+    display_params = _order_completion_params(click_group.params or [])
+    if display_params:
+        for param in display_params:
+            flags = ", ".join(param.opts)
+            if "--help" in flags:
+                continue
+            option_flags.append(flags)
+
+    help_flags = "--help, -h"
+    all_option_flags = [help_flags] + option_flags
+    all_display_names = [cmd["display_name"] for cmd in commands] + list(groups.keys())
+    all_labels = all_display_names + all_option_flags
+    longest_label_length = max((len(label) for label in all_labels), default=0)
+
+    console.print(f"[bold {COLOR.SECONDARY}]Usage:[/bold {COLOR.SECONDARY}]")
+    console.print(f"  [{COLOR.PRIMARY}]{command_name} [OPTIONS] [ARGUMENTS]")
+    console.print()
+
+    console.print(f"[bold {COLOR.SECONDARY}]Options:")
+
+    help_padding = " " * (longest_label_length - len(help_flags) + SPACER_LENGTH)
+    console.print(
+        f"  [{COLOR.OPTION}]{help_flags}[/{COLOR.OPTION}]{help_padding}Show this message and exit."
+    )
+
+    if display_params:
+        for param in display_params:
+            flags = ", ".join(param.opts)
+            if "--help" in flags:
+                continue
+            description = _get_option_description(param)
+            padding = " " * (longest_label_length - len(flags) + SPACER_LENGTH)
+            console.print(
+                f"  [{COLOR.OPTION}]{flags}[/{COLOR.OPTION}]{padding}{description}"
+            )
+    console.print()
+
+    if not prefix_filter:
+        console.print(f"[bold {COLOR.SECONDARY}]Available commands:")
+
+    top_level: list[CommandEntry] = [
+        c for c in commands if ":" not in c["name"] and c["name"] not in groups
+    ]
+    with_colon: list[CommandEntry] = [c for c in commands if ":" in c["name"]]
+
+    def print_command(cmd: CommandEntry) -> None:
+        """Print a single command with proper formatting."""
+        display_name = cmd["display_name"]
+        padding = " " * (longest_label_length - len(display_name) + SPACER_LENGTH)
+        console.print(
+            f"  [{COLOR.COMMAND} not bold]{display_name}[/{COLOR.COMMAND} not bold]{padding}{cmd['help']}"
+        )
+
+    for group_name, group_help in groups.items():
+        top_level.append(
+            {
+                "name": group_name,
+                "display_name": group_name,
+                "help": group_help,
+                "aliases": [],
+            }
+        )
+
+    top_level.sort(key=lambda x: x["name"])
+
+    if top_level:
+        for cmd in top_level:
+            print_command(cmd)
+        console.print()
+
+    sections: dict[str, list[CommandEntry]] = {}
+    for cmd in with_colon:
+        section_prefix = cmd["name"].split(":")[0]
+        if section_prefix not in sections:
+            sections[section_prefix] = []
+        sections[section_prefix].append(cmd)
+
+    for section_prefix, section_cmds in sections.items():
+        console.print(f"[bold {COLOR.SECONDARY}]{section_prefix}:")
+        for cmd in section_cmds:
+            print_command(cmd)
+        console.print()
+
+
+def list_group_commands(group_app: typer.Typer, group_name: str) -> None:
+    """List all commands within a specific command group.
+
+    Displays commands in a formatted list for a nested command group,
+    similar to how list_commands works for the main app.
+
+    Args:
+        group_app: The Typer sub-app for the command group.
+        group_name: The name of the command group.
+    """
+    alias_registry = _get_alias_registry(group_app)
+    alias_to_primary = _build_alias_to_primary(alias_registry)
+
+    command_name = get_script_command_name(default="usecli")
+
+    console.print(f"[bold {COLOR.SECONDARY}]Usage:[/bold {COLOR.SECONDARY}]")
+    console.print(
+        f"  [{COLOR.PRIMARY}]{command_name} {group_name} [COMMAND] [OPTIONS][/]"
+    )
+    console.print()
+    commands_by_name: dict[str, CommandMeta] = {}
+    for command in group_app.registered_commands:
+        callback = command.callback
+        name = command.name or (
+            getattr(callback, "__name__", "unknown") if callback else "unknown"
+        )
+        if name in alias_to_primary and alias_to_primary[name] != name:
+            continue
+        help_text = command.help or ""
+        if name not in commands_by_name or (
+            not commands_by_name[name]["help"] and help_text
+        ):
+            commands_by_name[name] = {
+                "help": help_text,
+                "aliases": alias_registry.get(name, list[str]()),
+            }
+
+    commands: list[CommandEntry] = []
+    for name in commands_by_name:
+        aliases = commands_by_name[name]["aliases"]
+        command_entry: CommandEntry = {
+            "name": name,
+            "display_name": _format_display_name(name, aliases),
+            "help": commands_by_name[name]["help"],
+            "aliases": aliases,
+        }
+        commands.append(command_entry)
+    commands.sort(key=lambda x: x["name"])
+
+    click_group = typer.main.get_command(group_app)
+    option_flags = []
+    display_params = _order_completion_params(click_group.params or [])
+    if display_params:
+        for param in display_params:
+            flags = ", ".join(param.opts)
+            if "--help" in flags:
+                continue
+            option_flags.append(flags)
+
+    help_flags = "--help, -h"
+    all_option_flags = [help_flags] + option_flags
+    all_display_names = [cmd["display_name"] for cmd in commands]
+    all_labels = all_display_names + all_option_flags
+    longest_label_length = max((len(label) for label in all_labels), default=0)
+
+    console.print(f"[bold {COLOR.SECONDARY}]Options:")
+    help_padding = " " * (longest_label_length - len(help_flags) + SPACER_LENGTH)
+    console.print(
+        f"  [{COLOR.OPTION}]{help_flags}[/{COLOR.OPTION}]{help_padding}Show this message and exit."
+    )
+
+    if display_params:
+        for param in display_params:
+            flags = ", ".join(param.opts)
+            if "--help" in flags:
+                continue
+            description = _get_option_description(param)
+            padding = " " * (longest_label_length - len(flags) + SPACER_LENGTH)
+            console.print(
+                f"  [{COLOR.OPTION}]{flags}[/{COLOR.OPTION}]{padding}{description}"
+            )
+    console.print()
+
+    console.print(f"[bold {COLOR.SECONDARY}]Available commands:")
+
+    for cmd in commands:
+        display_name = cmd["display_name"]
+        padding = " " * (longest_label_length - len(display_name) + SPACER_LENGTH)
+        console.print(
+            f"  [{COLOR.COMMAND}]{display_name}[/{COLOR.COMMAND}]{padding}{cmd['help']}"
+        )
+
+    console.print()
+
+
+def _get_alias_registry(app: typer.Typer) -> dict[str, list[str]]:
+    registry = getattr(app, "_usecli_aliases", {})
+    return registry if isinstance(registry, dict) else {}
+
+
+def _get_option_description(param: click.Parameter) -> str:
+    if "--show-completion" in param.opts:
+        return "Show completion for the current shell."
+    return getattr(param, "help", "") or ""
+
+
+def _order_completion_params(
+    params: list[click.Parameter],
+) -> list[click.Parameter]:
+    ordered = list(params)
+    install_index = None
+    show_index = None
+    for index, param in enumerate(ordered):
+        opts = set(param.opts)
+        if "--install-completion" in opts:
+            install_index = index
+        if "--show-completion" in opts:
+            show_index = index
+    if install_index is None or show_index is None:
+        return ordered
+    if install_index < show_index:
+        show_param = ordered.pop(show_index)
+        ordered.insert(install_index, show_param)
+        return ordered
+    if show_index < install_index:
+        install_param = ordered.pop(install_index)
+        ordered.insert(show_index, install_param)
+    return ordered
+
+
+def _build_alias_to_primary(alias_registry: dict[str, list[str]]) -> dict[str, str]:
+    alias_to_primary: dict[str, str] = {}
+    for primary, aliases in alias_registry.items():
+        alias_to_primary[primary] = primary
+        for alias in aliases:
+            alias_to_primary[alias] = primary
+    return alias_to_primary
+
+
+def _format_display_name(name: str, aliases: list[str]) -> str:
+    if not aliases:
+        return name
+    return f"{name}, {', '.join(aliases)}"

{usecli-0.1.29 → usecli-0.1.31}/src/usecli/cli/templates/command.py.j2

@@ -12,6 +12,9 @@ class {{ class_name }}(BaseCommand):
     def description(self) -> str:
         return "Description for {{ command_name }} command"
 
+    def aliases(self) -> list[str]:
+        return [{{ command_name[:3] }}]
+
     def handle(
         self,
         name: str = Argument(..., help="An example argument"),

usecli-0.1.29/src/usecli/cli/core/ui/list.py

@@ -1,217 +0,0 @@
-"""Command listing utilities for usecli CLI."""
-
-from __future__ import annotations
-
-from typing import TYPE_CHECKING
-
-import click
-import typer
-from rich.console import Console
-
-from usecli.cli.config.colors import COLOR
-from usecli.cli.core.ui.title import (
-    get_project_name,
-    get_script_command_name,
-    print_title,
-)
-
-if TYPE_CHECKING:
-    pass
-
-console = Console()
-
-SPACER_LENGTH = 18
-
-
-def list_commands(app: typer.Typer, prefix_filter: str | None = None) -> None:
-    """List all available commands with optional filtering.
-
-    Displays commands in a formatted list with sections for grouped commands
-    (those with colons in their names).
-
-    Args:
-        app: The Typer application instance.
-        prefix_filter: Optional prefix to filter commands by name.
-    """
-    project_name = get_project_name()
-    print_title(title=project_name)
-
-    click_group = typer.main.get_command(app)
-
-    all_command_names = list({cmd.name for cmd in app.registered_commands if cmd.name})
-    longest_name_length = (
-        max(len(name) for name in all_command_names) if all_command_names else 0
-    )
-
-    command_name = get_script_command_name(default="usecli")
-
-    console.print(f"[bold {COLOR.SECONDARY}]Usage:[/bold {COLOR.SECONDARY}]")
-    console.print(f"  [{COLOR.PRIMARY}]{command_name} [OPTIONS] [ARGUMENTS]")
-    console.print()
-
-    console.print(f"[bold {COLOR.SECONDARY}]Options:")
-
-    help_flags = "--help, -h"
-    help_padding = " " * (longest_name_length - len(help_flags) + SPACER_LENGTH)
-    console.print(
-        f"  [{COLOR.OPTION}]{help_flags}[/{COLOR.OPTION}]{help_padding}Show this message and exit."
-    )
-
-    if click_group.params:
-        for param in click_group.params:
-            flags = ", ".join(param.opts)
-            if "--help" in flags:
-                continue
-            description = getattr(param, "help", "") or ""
-            padding = " " * (longest_name_length - len(flags) + SPACER_LENGTH)
-            console.print(
-                f"  [{COLOR.OPTION}]{flags}[/{COLOR.OPTION}]{padding}{description}"
-            )
-    console.print()
-
-    commands_by_name: dict[str, str] = {}
-    for command in app.registered_commands:
-        callback = command.callback
-        name = command.name or (
-            getattr(callback, "__name__", "unknown") if callback else "unknown"
-        )
-        help_text = command.help or ""
-        if name not in commands_by_name or (not commands_by_name[name] and help_text):
-            commands_by_name[name] = help_text
-
-    commands = [
-        {"name": name, "help": help_text}
-        for name, help_text in commands_by_name.items()
-    ]
-    commands.sort(key=lambda x: x["name"])
-
-    if prefix_filter:
-        filtered = [c for c in commands if c["name"].startswith(prefix_filter)]
-        if not filtered:
-            console.print(f"  [dim]No commands found for '{prefix_filter}'[/dim]")
-            console.print()
-            return
-        commands = filtered
-
-    if not prefix_filter:
-        console.print(f"[bold {COLOR.SECONDARY}]Available commands:")
-
-    groups: dict[str, str] = {}
-    if isinstance(click_group, click.Group):
-        for cmd_name, cmd_obj in click_group.commands.items():
-            if isinstance(cmd_obj, click.Group):
-                groups[cmd_name] = (
-                    getattr(cmd_obj, "help", f"Commands for {cmd_name}")
-                    or f"Commands for {cmd_name}"
-                )
-
-    top_level = [
-        c for c in commands if ":" not in c["name"] and c["name"] not in groups
-    ]
-    with_colon = [c for c in commands if ":" in c["name"]]
-
-    all_names = all_command_names + list(groups.keys())
-    if all_names:
-        longest_name_length = max(len(name) for name in all_names)
-
-    def print_command(cmd: dict[str, str]) -> None:
-        """Print a single command with proper formatting."""
-        padding = " " * (longest_name_length - len(cmd["name"]) + SPACER_LENGTH)
-        console.print(
-            f"  [{COLOR.COMMAND} not bold]{cmd['name']}[/{COLOR.COMMAND} not bold]{padding}{cmd['help']}"
-        )
-
-    for group_name, group_help in groups.items():
-        top_level.append({"name": group_name, "help": group_help})
-
-    top_level.sort(key=lambda x: x["name"])
-
-    if top_level:
-        for cmd in top_level:
-            print_command(cmd)
-        console.print()
-
-    sections: dict[str, list[dict[str, str]]] = {}
-    for cmd in with_colon:
-        section_prefix = cmd["name"].split(":")[0]
-        if section_prefix not in sections:
-            sections[section_prefix] = []
-        sections[section_prefix].append(cmd)
-
-    for section_prefix, section_cmds in sections.items():
-        console.print(f"[bold {COLOR.SECONDARY}]{section_prefix}:")
-        for cmd in section_cmds:
-            print_command(cmd)
-        console.print()
-
-
-def list_group_commands(group_app: typer.Typer, group_name: str) -> None:
-    """List all commands within a specific command group.
-
-    Displays commands in a formatted list for a nested command group,
-    similar to how list_commands works for the main app.
-
-    Args:
-        group_app: The Typer sub-app for the command group.
-        group_name: The name of the command group.
-    """
-    all_command_names = list(
-        {cmd.name for cmd in group_app.registered_commands if cmd.name}
-    )
-    longest_name_length = (
-        max(len(name) for name in all_command_names) if all_command_names else 0
-    )
-
-    command_name = get_script_command_name(default="usecli")
-
-    console.print(f"[bold {COLOR.SECONDARY}]Usage:[/bold {COLOR.SECONDARY}]")
-    console.print(
-        f"  [{COLOR.PRIMARY}]{command_name} {group_name} [COMMAND] [OPTIONS][/]"
-    )
-    console.print()
-
-    console.print(f"[bold {COLOR.SECONDARY}]Options:")
-    help_flags = "--help, -h"
-    help_padding = " " * (longest_name_length - len(help_flags) + SPACER_LENGTH)
-    console.print(
-        f"  [{COLOR.OPTION}]{help_flags}[/{COLOR.OPTION}]{help_padding}Show this message and exit."
-    )
-
-    click_group = typer.main.get_command(group_app)
-    if click_group.params:
-        for param in click_group.params:
-            flags = ", ".join(param.opts)
-            if "--help" in flags:
-                continue
-            description = getattr(param, "help", "") or ""
-            padding = " " * (longest_name_length - len(flags) + SPACER_LENGTH)
-            console.print(
-                f"  [{COLOR.OPTION}]{flags}[/{COLOR.OPTION}]{padding}{description}"
-            )
-    console.print()
-
-    commands_by_name: dict[str, str] = {}
-    for command in group_app.registered_commands:
-        callback = command.callback
-        name = command.name or (
-            getattr(callback, "__name__", "unknown") if callback else "unknown"
-        )
-        help_text = command.help or ""
-        if name not in commands_by_name or (not commands_by_name[name] and help_text):
-            commands_by_name[name] = help_text
-
-    commands = [
-        {"name": name, "help": help_text}
-        for name, help_text in commands_by_name.items()
-    ]
-    commands.sort(key=lambda x: x["name"])
-
-    console.print(f"[bold {COLOR.SECONDARY}]Available commands:")
-
-    for cmd in commands:
-        padding = " " * (longest_name_length - len(cmd["name"]) + SPACER_LENGTH)
-        console.print(
-            f"  [{COLOR.COMMAND}]{cmd['name']}[/{COLOR.COMMAND}]{padding}{cmd['help']}"
-        )
-
-    console.print()