lql-cli 0.3.0__tar.gz → 0.5.0__tar.gz

lql_cli-0.3.0/README.md → lql_cli-0.5.0/PKG-INFO

@@ -1,8 +1,24 @@
+Metadata-Version: 2.4
+Name: lql-cli
+Version: 0.5.0
+Summary: lql — CLI for the Liquid DataViewer platform
+Project-URL: Homepage, https://github.com/Liquid4All/lql
+Author: Liquid AI
+License: MIT
+Requires-Python: >=3.12
+Requires-Dist: httpx>=0.27
+Requires-Dist: huggingface-hub>=0.24
+Requires-Dist: rich>=13.0
+Requires-Dist: textual-image>=0.7
+Requires-Dist: textual>=0.50
+Requires-Dist: typer>=0.12
+Description-Content-Type: text/markdown
+
 # lql — Liquid Query Language CLI
 
 Scriptable CLI for the [Liquid DataViewer](https://dataviewer.liquid.ai) platform. Designed for both humans and AI agents (Claude Code, Codex, etc.) to automate datasets, eval analysis, spec docs, annotations, and more.
 
-A Python package (Python ≥ 3.9), published on PyPI as **[`lql-cli`](https://pypi.org/project/lql-cli/)** — the installed command is `lql`.
+A Python package (Python ≥ 3.12), published on PyPI as **[`lql-cli`](https://pypi.org/project/lql-cli/)** — the installed command is `lql`.
 
 ## Quick start
 
@@ -14,7 +30,7 @@ lql skills install                    # teach Claude Code + Codex how to use lql
 
 ## Install
 
-`lql` is a Python package (requires Python ≥ 3.9), distributed on PyPI as **`lql-cli`** (the
+`lql` is a Python package (requires Python ≥ 3.12), distributed on PyPI as **`lql-cli`** (the
 command it installs is `lql`). Install it as a standalone CLI tool with
 [uv](https://docs.astral.sh/uv/):
 
@@ -84,6 +100,13 @@ lql logout
 
 ## Command reference
 
+Running a group with no subcommand (e.g. `lql datasets`) lists its subcommands.
+For faster typing, **aliases** and **unique prefixes** resolve everywhere:
+group aliases (`ds`, `ws`, `ev`, `ann`, `hl`, `rep`, `bkt`, `iss`), verb aliases
+(`ls`=list, `rm`/`del`=delete, `new`/`mk`=create, `info`=show), and prefixes
+(`lql datasets l` → `list`). So `lql ds ls --workspace <id>` ≡ `lql datasets list
+--workspace <id>`. The canonical names below always work (use those in scripts).
+
 ### Auth
 
 ```
@@ -95,7 +118,7 @@ lql whoami                       Show current user
 ### Workspaces
 
 ```
-lql workspaces list                              List all workspaces
+lql workspaces list [--search <text>]            List workspaces (--search filters by name/slug)
 lql workspaces create <name>                     Create a workspace
 lql workspaces show <id>                         Show workspace details
 lql workspaces update <id> --name <n>            Rename a workspace
@@ -108,7 +131,7 @@ lql workspaces members remove <id> <uid>         Remove member by user ID
 ### Datasets
 
 ```
-lql datasets list [--workspace <id>]             List datasets
+lql datasets list [--workspace <id>] [--search <text>]   List datasets (--search filters by name/HF repo)
 lql datasets show <id>                           Show dataset details
 lql datasets create --workspace <id> --hf-repo <repo> [--name <n>] [--split <s>]
 lql datasets create --workspace <id> --hf-bucket <org/bucket> --key <path-or-glob> [--name <n>]
@@ -134,23 +157,43 @@ multimodal content (text/image/audio), ShareGPT `{from, value}`, native OpenAI
 `tool_calls`, plus `<think>` reasoning blocks, `<|tool_call_start|>…<|tool_call_end|>`
 / Python / XML / JSON tool calls, tool results, tool-definition tables, and code.
 
-Works on a local `.jsonl`/`.json` file or a platform dataset ID. No browser, and
-nothing to forward over SSH — it's just the terminal.
+Works on a local `.jsonl`/`.json` file, a platform dataset ID, or — with `--hf`
+— a HuggingFace repo. No browser, and nothing to forward over SSH — it's just
+the terminal.
 
 ```
 lql preview <file.jsonl|file.json>     Local file: each line/object is a row
 lql preview <dataset-id>               Platform dataset (fetched & paged lazily)
+lql preview <org/name> --hf            HuggingFace repo: sync to DataViewer, then view
 lql preview <src> -c <field>           Force field(s) as conversations (repeatable)
 lql preview <src> -n <N>               Page size when paging a platform dataset
 lql preview <src> --offset N           Start at row index N
 lql preview <src> --title "<title>"    Title shown in the viewer header
 ```
 
+**HuggingFace datasets (`--hf`).** `lql preview org/name --hf` syncs the repo
+into a DataViewer workspace, then opens it. You pick the target workspace from
+an interactive list (or pass `--workspace <id>`; `--split` defaults to `train`).
+Already-synced repos are reused — no duplicate, instant re-open.
+
+```
+lql preview tatsu-lab/alpaca --hf
+lql preview org/name --hf --split validation --workspace <id>
+```
+
+**Media.** Images render **inline** in terminals that support an image protocol
+(Kitty/Ghostty, iTerm2, Sixel; falls back to a compact `🖼 …` placeholder
+elsewhere) — both multimodal `image_url`/data-URI segments and image-mode
+columns. Audio can't play inline in a terminal, so each clip shows a `♪` line
+and **`p` plays** the current sample's audio via the system player (`afplay`/
+`open`). Images render inline in pager mode (one sample at a time); scroll mode
+shows placeholders to avoid decoding the whole buffer.
+
 **Navigation** — two modes, toggle with `m` / `Tab`:
 
 - **pager** (default): one sample at a time · `←/→` or `n`/`b` switch samples · `↑/↓`/`j`/`k`/PgUp-Dn scroll
 - **scroll**: all samples in one buffer · `n`/`b` jump between samples · arrows scroll
-- `q` quits
+- `p` play audio · `q` quits
 
 ```
 lql preview examples/agent-traces.jsonl     # 20-sample file of agent-trace/tool-use formats

lql_cli-0.3.0/PKG-INFO → lql_cli-0.5.0/README.md

@@ -1,23 +1,8 @@
-Metadata-Version: 2.4
-Name: lql-cli
-Version: 0.3.0
-Summary: lql — CLI for the Liquid DataViewer platform
-Project-URL: Homepage, https://github.com/Liquid4All/lql
-Author: Liquid AI
-License: MIT
-Requires-Python: >=3.9
-Requires-Dist: httpx>=0.27
-Requires-Dist: huggingface-hub>=0.24
-Requires-Dist: rich>=13.0
-Requires-Dist: textual>=0.50
-Requires-Dist: typer>=0.12
-Description-Content-Type: text/markdown
-
 # lql — Liquid Query Language CLI
 
 Scriptable CLI for the [Liquid DataViewer](https://dataviewer.liquid.ai) platform. Designed for both humans and AI agents (Claude Code, Codex, etc.) to automate datasets, eval analysis, spec docs, annotations, and more.
 
-A Python package (Python ≥ 3.9), published on PyPI as **[`lql-cli`](https://pypi.org/project/lql-cli/)** — the installed command is `lql`.
+A Python package (Python ≥ 3.12), published on PyPI as **[`lql-cli`](https://pypi.org/project/lql-cli/)** — the installed command is `lql`.
 
 ## Quick start
 
@@ -29,7 +14,7 @@ lql skills install                    # teach Claude Code + Codex how to use lql
 
 ## Install
 
-`lql` is a Python package (requires Python ≥ 3.9), distributed on PyPI as **`lql-cli`** (the
+`lql` is a Python package (requires Python ≥ 3.12), distributed on PyPI as **`lql-cli`** (the
 command it installs is `lql`). Install it as a standalone CLI tool with
 [uv](https://docs.astral.sh/uv/):
 
@@ -99,6 +84,13 @@ lql logout
 
 ## Command reference
 
+Running a group with no subcommand (e.g. `lql datasets`) lists its subcommands.
+For faster typing, **aliases** and **unique prefixes** resolve everywhere:
+group aliases (`ds`, `ws`, `ev`, `ann`, `hl`, `rep`, `bkt`, `iss`), verb aliases
+(`ls`=list, `rm`/`del`=delete, `new`/`mk`=create, `info`=show), and prefixes
+(`lql datasets l` → `list`). So `lql ds ls --workspace <id>` ≡ `lql datasets list
+--workspace <id>`. The canonical names below always work (use those in scripts).
+
 ### Auth
 
 ```
@@ -110,7 +102,7 @@ lql whoami                       Show current user
 ### Workspaces
 
 ```
-lql workspaces list                              List all workspaces
+lql workspaces list [--search <text>]            List workspaces (--search filters by name/slug)
 lql workspaces create <name>                     Create a workspace
 lql workspaces show <id>                         Show workspace details
 lql workspaces update <id> --name <n>            Rename a workspace
@@ -123,7 +115,7 @@ lql workspaces members remove <id> <uid>         Remove member by user ID
 ### Datasets
 
 ```
-lql datasets list [--workspace <id>]             List datasets
+lql datasets list [--workspace <id>] [--search <text>]   List datasets (--search filters by name/HF repo)
 lql datasets show <id>                           Show dataset details
 lql datasets create --workspace <id> --hf-repo <repo> [--name <n>] [--split <s>]
 lql datasets create --workspace <id> --hf-bucket <org/bucket> --key <path-or-glob> [--name <n>]
@@ -149,23 +141,43 @@ multimodal content (text/image/audio), ShareGPT `{from, value}`, native OpenAI
 `tool_calls`, plus `<think>` reasoning blocks, `<|tool_call_start|>…<|tool_call_end|>`
 / Python / XML / JSON tool calls, tool results, tool-definition tables, and code.
 
-Works on a local `.jsonl`/`.json` file or a platform dataset ID. No browser, and
-nothing to forward over SSH — it's just the terminal.
+Works on a local `.jsonl`/`.json` file, a platform dataset ID, or — with `--hf`
+— a HuggingFace repo. No browser, and nothing to forward over SSH — it's just
+the terminal.
 
 ```
 lql preview <file.jsonl|file.json>     Local file: each line/object is a row
 lql preview <dataset-id>               Platform dataset (fetched & paged lazily)
+lql preview <org/name> --hf            HuggingFace repo: sync to DataViewer, then view
 lql preview <src> -c <field>           Force field(s) as conversations (repeatable)
 lql preview <src> -n <N>               Page size when paging a platform dataset
 lql preview <src> --offset N           Start at row index N
 lql preview <src> --title "<title>"    Title shown in the viewer header
 ```
 
+**HuggingFace datasets (`--hf`).** `lql preview org/name --hf` syncs the repo
+into a DataViewer workspace, then opens it. You pick the target workspace from
+an interactive list (or pass `--workspace <id>`; `--split` defaults to `train`).
+Already-synced repos are reused — no duplicate, instant re-open.
+
+```
+lql preview tatsu-lab/alpaca --hf
+lql preview org/name --hf --split validation --workspace <id>
+```
+
+**Media.** Images render **inline** in terminals that support an image protocol
+(Kitty/Ghostty, iTerm2, Sixel; falls back to a compact `🖼 …` placeholder
+elsewhere) — both multimodal `image_url`/data-URI segments and image-mode
+columns. Audio can't play inline in a terminal, so each clip shows a `♪` line
+and **`p` plays** the current sample's audio via the system player (`afplay`/
+`open`). Images render inline in pager mode (one sample at a time); scroll mode
+shows placeholders to avoid decoding the whole buffer.
+
 **Navigation** — two modes, toggle with `m` / `Tab`:
 
 - **pager** (default): one sample at a time · `←/→` or `n`/`b` switch samples · `↑/↓`/`j`/`k`/PgUp-Dn scroll
 - **scroll**: all samples in one buffer · `n`/`b` jump between samples · arrows scroll
-- `q` quits
+- `p` play audio · `q` quits
 
 ```
 lql preview examples/agent-traces.jsonl     # 20-sample file of agent-trace/tool-use formats

{lql_cli-0.3.0 → lql_cli-0.5.0}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "hatchling.build"
 
 [project]
 name = "lql-cli"
-version = "0.3.0"
+version = "0.5.0"
 description = "lql — CLI for the Liquid DataViewer platform"
 readme = "README.md"
-requires-python = ">=3.9"
+requires-python = ">=3.12"
 license = { text = "MIT" }
 authors = [{ name = "Liquid AI" }]
 dependencies = [
@@ -16,6 +16,7 @@ dependencies = [
     "rich>=13.0",
     "huggingface-hub>=0.24",
     "textual>=0.50",
+    "textual-image>=0.7",
 ]
 
 [project.scripts]

lql_cli-0.5.0/src/lql/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.5.0"

lql_cli-0.5.0/src/lql/_group.py

@@ -0,0 +1,50 @@
+"""A Typer/Click group that adds two conveniences to every command group:
+
+  * short aliases  — `ds`→`datasets`, `ws`→`workspaces`, `ls`→`list`, …
+  * unique-prefix matching — `lql datasets l` resolves to `list`
+
+Both are purely additive: the canonical command names always work, and
+`lql instructions` documents the canonical forms, so agents are unaffected —
+these are conveniences for humans typing at a prompt.
+"""
+
+from typer.core import TyperGroup
+
+# alias -> canonical. Kept intentionally small and unambiguous.
+ALIASES = {
+    # command groups
+    "ds": "datasets",
+    "ws": "workspaces",
+    "ev": "eval",
+    "evals": "eval",
+    "ann": "annotations",
+    "hl": "highlights",
+    "rep": "reports",
+    "bkt": "buckets",
+    "iss": "issues",
+    # verbs
+    "ls": "list",
+    "rm": "delete",
+    "del": "delete",
+    "new": "create",
+    "mk": "create",
+    "info": "show",
+}
+
+
+class AliasGroup(TyperGroup):
+    def get_command(self, ctx, name):
+        # Exact name first so a real command is never shadowed by an alias;
+        # then explicit alias; then an unambiguous prefix.
+        cmd = super().get_command(ctx, name)
+        if cmd is not None:
+            return cmd
+        alias = ALIASES.get(name)
+        if alias is not None:
+            cmd = super().get_command(ctx, alias)
+            if cmd is not None:
+                return cmd
+        matches = [c for c in self.list_commands(ctx) if c.startswith(name)]
+        if len(matches) == 1:
+            return super().get_command(ctx, matches[0])
+        return None

{lql_cli-0.3.0 → lql_cli-0.5.0}/src/lql/cli.py

@@ -3,6 +3,8 @@ from typing import Annotated, Optional
 
 import typer
 
+from ._group import AliasGroup
+
 from . import __version__
 from .output import print_error
 from .commands import (
@@ -32,6 +34,7 @@ app = typer.Typer(
     ),
     no_args_is_help=True,
     add_completion=False,
+    cls=AliasGroup,
 )
 
 

{lql_cli-0.3.0 → lql_cli-0.5.0}/src/lql/commands/annotations.py

@@ -3,13 +3,15 @@ from typing import Annotated, Optional
 
 import typer
 
+from .._group import AliasGroup
+
 from .._opts import ApiUrlOpt, JsonOpt, ProfileOpt
 from ..api import ApiClient
 from ..output import print_json, print_table
 from ..sessions import resolve_session_id
 from ..util import q
 
-app = typer.Typer(help="Manage annotations")
+app = typer.Typer(help="Manage annotations", cls=AliasGroup, no_args_is_help=True)
 
 SessionOpt = Annotated[Optional[str], typer.Option("--session", help="Target a specific review session (advanced)")]
 

{lql_cli-0.3.0 → lql_cli-0.5.0}/src/lql/commands/auth.py

@@ -7,6 +7,8 @@ from typing import Annotated, Optional
 import httpx
 import typer
 
+from .._group import AliasGroup
+
 from .._opts import ApiUrlOpt, JsonOpt, ProfileOpt
 from ..api import ApiClient
 from ..config import get_api_url, read_config, validate_api_url, write_config
@@ -148,7 +150,7 @@ def whoami(
         )
 
 
-auth_app = typer.Typer(help="Authentication commands")
+auth_app = typer.Typer(help="Authentication commands", cls=AliasGroup, no_args_is_help=True)
 auth_app.command("login")(login)
 auth_app.command("logout")(logout)
 auth_app.command("whoami")(whoami)

{lql_cli-0.3.0 → lql_cli-0.5.0}/src/lql/commands/buckets.py

@@ -4,12 +4,14 @@ from typing import Annotated, Optional
 
 import typer
 
+from .._group import AliasGroup
+
 from .._opts import ApiUrlOpt, JsonOpt, ProfileOpt
 from ..api import ApiClient
 from ..output import print_json, print_table
 from ..util import q
 
-app = typer.Typer(help="Manage S3 and Hugging Face buckets")
+app = typer.Typer(help="Manage S3 and Hugging Face buckets", cls=AliasGroup, no_args_is_help=True)
 
 
 @app.command("list")

{lql_cli-0.3.0 → lql_cli-0.5.0}/src/lql/commands/datasets.py

@@ -6,12 +6,14 @@ from typing import Annotated, Optional
 
 import typer
 
+from .._group import AliasGroup
+
 from .._opts import ApiUrlOpt, JsonOpt, ProfileOpt
 from ..api import ApiClient
 from ..output import print_error, print_json, print_table
 from ..util import q
 
-app = typer.Typer(help="Manage datasets")
+app = typer.Typer(help="Manage datasets", cls=AliasGroup, no_args_is_help=True)
 
 
 def _truncate(v: object, n: int = 80) -> str:
@@ -22,6 +24,10 @@ def _truncate(v: object, n: int = 80) -> str:
 @app.command("list")
 def list_datasets(
     workspace: Annotated[Optional[str], typer.Option("--workspace", help="Filter by workspace ID")] = None,
+    search: Annotated[
+        Optional[str],
+        typer.Option("--search", "-s", help="Filter by case-insensitive substring of name / HF repo"),
+    ] = None,
     json_out: JsonOpt = False,
     profile: ProfileOpt = None,
     api_url: ApiUrlOpt = None,
@@ -32,6 +38,15 @@ def list_datasets(
     if workspace:
         params["workspace_id"] = workspace
     items = client.get("/v1/datasets", params=params).json()
+    if search:
+        s = search.lower()
+        items = [
+            d
+            for d in items
+            if s in (d.get("display_name") or "").lower()
+            or s in (d.get("name") or "").lower()
+            or s in (d.get("hf_repo_id") or "").lower()
+        ]
     print_table(
         ["ID", "Name", "Workspace", "Rows"],
         [

{lql_cli-0.3.0 → lql_cli-0.5.0}/src/lql/commands/edits.py

@@ -4,12 +4,14 @@ from typing import Annotated, Optional
 
 import typer
 
+from .._group import AliasGroup
+
 from .._opts import ApiUrlOpt, JsonOpt, ProfileOpt
 from ..api import ApiClient
 from ..output import print_error, print_json, print_table
 from ..util import q
 
-app = typer.Typer(help="Manage row edits")
+app = typer.Typer(help="Manage row edits", cls=AliasGroup, no_args_is_help=True)
 
 
 @app.command("list")

{lql_cli-0.3.0 → lql_cli-0.5.0}/src/lql/commands/evals.py

@@ -6,12 +6,14 @@ from typing import Annotated, List, Optional
 
 import typer
 
+from .._group import AliasGroup
+
 from .._opts import ApiUrlOpt, JsonOpt, ProfileOpt
 from ..api import ApiClient
 from ..output import print_error, print_json, print_table
 from ..util import q
 
-app = typer.Typer(help="Inspect and analyze eval datasets (accuracy, failure modes, samples)")
+app = typer.Typer(help="Inspect and analyze eval datasets (accuracy, failure modes, samples)", cls=AliasGroup, no_args_is_help=True)
 
 # Mirrors front/src/lib/eval-dataset.ts so `eval samples --search` searches the
 # same prompt/response columns the eval views do.

{lql_cli-0.3.0 → lql_cli-0.5.0}/src/lql/commands/highlights.py

@@ -3,13 +3,15 @@ from typing import Annotated, Optional
 
 import typer
 
+from .._group import AliasGroup
+
 from .._opts import ApiUrlOpt, JsonOpt, ProfileOpt
 from ..api import ApiClient
 from ..output import print_error, print_json, print_table
 from ..sessions import resolve_session_id
 from ..util import q
 
-app = typer.Typer(help="Manage highlights")
+app = typer.Typer(help="Manage highlights", cls=AliasGroup, no_args_is_help=True)
 
 SessionOpt = Annotated[Optional[str], typer.Option("--session", help="Target a specific review session (advanced)")]
 

{lql_cli-0.3.0 → lql_cli-0.5.0}/src/lql/commands/instructions.py

@@ -8,6 +8,15 @@ INSTRUCTIONS = r"""
 CLI for the DataViewer platform. Gives agents and humans complete scriptable
 control over workspaces, datasets, spec docs, annotations, and S3.
 
+Running a group with no subcommand (e.g. `lql datasets`) lists its subcommands.
+
+Shortcuts (for humans typing): group aliases (`ds`=datasets, `ws`=workspaces,
+`ev`=eval, `ann`=annotations, `hl`=highlights, `rep`=reports, `bkt`=buckets,
+`iss`=issues), verb aliases (`ls`=list, `rm`/`del`=delete, `new`/`mk`=create,
+`info`=show), and unique prefixes (`lql datasets l` → list) all resolve.
+AGENTS: use the full canonical names shown throughout this reference — they are
+the stable contract; the aliases are conveniences layered on top.
+
 ## Authentication
 
   lql login                   # Open browser → click Authorize → token stored automatically
@@ -43,7 +52,7 @@ Pagination: --limit N --offset N on list commands.
 
 A workspace is the top-level container for datasets, spec docs, and members.
 
-  lql workspaces list
+  lql workspaces list [--search <text>]            # --search filters by name / slug substring
   lql workspaces create <name>
   lql workspaces show <id>
   lql workspaces update <id> --name <new-name>
@@ -54,7 +63,7 @@ A workspace is the top-level container for datasets, spec docs, and members.
 
 ## Datasets
 
-  lql datasets list [--workspace <id>]
+  lql datasets list [--workspace <id>] [--search <text>]   # --search filters by name / HF repo substring
   lql datasets show <id>
   lql datasets create --workspace <id> --hf-repo <org/repo> [--name <display>] [--split <split>]
   lql datasets create --workspace <id> --hf-bucket <org/bucket> --key <path-or-glob> [--name <display>]
@@ -83,16 +92,26 @@ Non-conversation fields render as labeled metadata.
 
   lql preview <file.jsonl|file.json>     # local file: each line/object is a row
   lql preview <dataset-id>               # platform dataset, fetched & paged lazily
+  lql preview <org/name> --hf            # HuggingFace repo: sync to DataViewer, then view
   lql preview data.jsonl -c messages     # force field(s) as conversations
 
+With --hf, SOURCE is a HuggingFace repo (org/name): it's synced into a
+DataViewer workspace (you pick one interactively, or pass --workspace <id>;
+--split defaults to train) and reused on later previews (dedup by repo+split).
+
 Options: -c/--column (field(s) to treat as conversations; default auto-detect,
 repeatable), -n/--limit (page size when paging a platform dataset), --offset
-(start row index), --title, --profile, --api-url.
+(start row index), --title, --hf, --split, --workspace, --profile, --api-url.
 
 Navigation: two modes toggled with m/Tab — pager (one sample at a time; ←/→ or
 n/b switch samples, ↑/↓/j/k scroll) and scroll (all samples; n/b jump between
 them). q quits. Works over plain SSH with no browser or port-forward.
 
+Media: images render inline in image-capable terminals (Kitty/Ghostty, iTerm2,
+Sixel; placeholder otherwise) for both multimodal image segments and image-mode
+columns; audio shows a ♪ line and `p` plays the current sample's clip via the
+system player (afplay/open).
+
 ## Evals
 
 Eval datasets (evaluation-run output: each row a sample with a model 'response'
@@ -215,7 +234,9 @@ never goes stale.
 
 ### Discover workspaces and datasets
   lql workspaces list --json
+  lql workspaces list --search <name> --json        # find a workspace by name
   lql datasets list --workspace <id> --json
+  lql datasets list --search <name> --json           # find a dataset by name / HF repo
 
 ### Read dataset contents
   lql datasets schema <id> --json

{lql_cli-0.3.0 → lql_cli-0.5.0}/src/lql/commands/issues.py

@@ -3,12 +3,14 @@ from typing import Annotated, Optional
 
 import typer
 
+from .._group import AliasGroup
+
 from .._opts import ApiUrlOpt, JsonOpt, ProfileOpt
 from ..api import ApiClient
 from ..output import print_json, print_table
 from ..util import q
 
-app = typer.Typer(help="Manage issues")
+app = typer.Typer(help="Manage issues", cls=AliasGroup, no_args_is_help=True)
 
 
 @app.command("list")