Skip to content

"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/

Python

feat(cli-hub): bump to 0.4.0 and add CLI-Matrix analytics

yuhaodc7392489222
diff --git a/cli-hub/cli_hub/__init__.py b/cli-hub/cli_hub/__init__.py
index a0fca10c3..b5cd191c5 100644
--- a/cli-hub/cli_hub/__init__.py
+++ b/cli-hub/cli_hub/__init__.py
@@ -1,3 +1,3 @@
"""cli-hub — Download, manage, and browse CLI-Anything harnesses."""
-__version__ = "0.3.0"
+__version__ = "0.4.0"
diff --git a/cli-hub/cli_hub/analytics.py b/cli-hub/cli_hub/analytics.py
index a5632d364..714304ccb 100644
--- a/cli-hub/cli_hub/analytics.py
+++ b/cli-hub/cli_hub/analytics.py
@@ -308,6 +308,57 @@ def track_launch(cli_name):
})
+def track_matrix_install(matrix_name, scope="full", status="ok",
+ installed=0, skipped=0, failed=0, dry_run=False):
+ """Track a CLI-Matrix install. The headline conversion signal for matrices:
+ which matrix, the install scope (capability/recipe/only/full), and the outcome.
+ Matrix name and scope go in properties so the event catalog stays flat — dashboards
+ break down by properties.matrix / properties.scope, mirroring track_install."""
+ track_event("matrix-install", url=f"/cli-anything-hub/matrix/install/{matrix_name}", data={
+ "matrix": matrix_name,
+ "scope": scope,
+ "status": status,
+ "installed": installed,
+ "skipped": skipped,
+ "failed": failed,
+ "dry_run": dry_run,
+ "platform": platform.system().lower(),
+ })
+
+
+def track_matrix_preflight(matrix_name, scope="full", covered=0, capabilities=0, gaps=0):
+ """Track a CLI-Matrix preflight (capability-coverage check) — consideration signal
+ that precedes install. Captures how much of the matrix the environment already covers."""
+ track_event("matrix-preflight", url=f"/cli-anything-hub/matrix/preflight/{matrix_name}", data={
+ "matrix": matrix_name,
+ "scope": scope,
+ "covered": covered,
+ "capabilities": capabilities,
+ "gaps": gaps,
+ "platform": platform.system().lower(),
+ })
+
+
+def track_matrix_discover(kind, query="", results=0):
+ """Track CLI-Matrix discovery — `matrix list`, `matrix search`, `matrix recipes`,
+ and `cli-hub can`. `kind` distinguishes the surface; `results` is the hit count."""
+ track_event("matrix-discover", url="/cli-anything-hub/matrix/discover", data={
+ "kind": kind,
+ "query": (query or "")[:120],
+ "results": results,
+ "platform": platform.system().lower(),
+ })
+
+
+def track_matrix_info(matrix_name, kind="info"):
+ """Track inspecting a single CLI-Matrix — `matrix info` and `matrix doctor`."""
+ track_event("matrix-info", url=f"/cli-anything-hub/matrix/info/{matrix_name}", data={
+ "matrix": matrix_name,
+ "kind": kind,
+ "platform": platform.system().lower(),
+ })
+
+
def track_visit(is_agent=False, command="root", detection=None):
"""Track a cli-hub invocation using the new cli-hub call event."""
stdin_tty = _stdin_is_tty()
diff --git a/cli-hub/cli_hub/cli.py b/cli-hub/cli_hub/cli.py
index a2f3fba96..d037a6539 100644
--- a/cli-hub/cli_hub/cli.py
+++ b/cli-hub/cli_hub/cli.py
@@ -36,6 +36,10 @@ from cli_hub.analytics import (
track_first_run,
track_install,
track_launch,
+ track_matrix_discover,
+ track_matrix_info,
+ track_matrix_install,
+ track_matrix_preflight,
track_uninstall,
track_visit,
)
@@ -409,6 +413,7 @@ def preview_open(preview_ref, output_path, poll_ms, port):
def can(query, as_json):
"""Find a capability across all matrices for a task (e.g. cli-hub can "transcribe audio")."""
hits = search_capabilities(query)
+ track_matrix_discover("can", query=query, results=len(hits))
if as_json:
click.echo(json_mod.dumps({"query": query, "matched_capabilities": hits}, indent=2))
@@ -460,6 +465,7 @@ def list_matrices(as_json):
click.secho(f"Failed to fetch matrix registry: {e}", fg="red", err=True)
raise SystemExit(1)
+ track_matrix_discover("list", results=len(matrices))
installed = get_installed()
if as_json:
@@ -489,6 +495,7 @@ def list_matrices(as_json):
def matrix_search(query, as_json):
"""Search matrices by name, capabilities, providers, recipes, or gaps."""
results = search_matrices(query)
+ track_matrix_discover("search", query=query, results=len(results))
query_lower = query.lower()
if as_json:
@@ -545,6 +552,7 @@ def matrix_info(name, as_json):
click.secho(f"Matrix '{name}' not found.", fg="red", err=True)
raise SystemExit(1)
+ track_matrix_info(matrix_item["name"], kind="info")
installed = get_installed()
cli_names = matrix_item.get("clis", [])
installed_count = sum(1 for cli_name in cli_names if cli_name in installed)
@@ -666,6 +674,15 @@ def matrix_preflight(name, capability, recipe, offline, fix_hints, summary_only,
matrix_item, capability_id=capability, offline=offline, capability_ids=capability_ids
)
+ _preflight_summary = payload.get("summary", {})
+ track_matrix_preflight(
+ matrix_item["name"],
+ scope=_matrix_scope_kind(capability, recipe, None),
+ covered=_preflight_summary.get("covered", 0),
+ capabilities=_preflight_summary.get("capabilities", 0),
+ gaps=_preflight_summary.get("gaps", 0),
+ )
+
if as_json:
click.echo(json_mod.dumps(payload, indent=2))
raise SystemExit(EXIT_PARTIAL if payload["summary"].get("gaps", 0) else EXIT_OK)
@@ -780,6 +797,17 @@ def _render_dry_run(payload):
+ _scope_args(payload["scope"]))
+def _matrix_scope_kind(capability, recipe, only):
+ """Compact scope label for analytics breakdowns (not the echoed flags)."""
+ if capability:
+ return "capability"
+ if recipe:
+ return "recipe"
+ if only:
+ return "only"
+ return "full"
+
+
def _scope_args(scope):
"""Reconstruct the scope flags for an echoed command line."""
scope_type = scope.get("type")
@@ -817,6 +845,11 @@ def matrix_install(name, capability, recipe, only, dry_run, resume, skill_only,
click.secho(f"Matrix '{name}' not found.", fg="red", err=True)
raise SystemExit(EXIT_FAIL)
rendered_skill_path = render_matrix_skill_file(matrix_item, installed=get_installed())
+ track_matrix_install(
+ matrix_item["name"],
+ scope=_matrix_scope_kind(capability, recipe, only),
+ status="skill_only",
+ )
click.echo(f" Local matrix skill: {rendered_skill_path}")
click.echo(f" Install CLIs: cli-hub matrix install {matrix_item['name']}")
return
@@ -829,6 +862,12 @@ def matrix_install(name, capability, recipe, only, dry_run, resume, skill_only,
else:
click.secho(f"✗ {payload['error']}", fg="red", err=True)
raise SystemExit(EXIT_USAGE if payload.get("arg_error") else EXIT_FAIL)
+ track_matrix_install(
+ payload["matrix"]["name"],
+ scope=_matrix_scope_kind(capability, recipe, only),
+ status="dry_run",
+ dry_run=True,
+ )
if as_json:
data = {k: payload[k] for k in ("scope", "scope_label", "plan", "not_managed", "summary")}
data["matrix"] = payload["matrix"]["name"]
@@ -841,6 +880,11 @@ def matrix_install(name, capability, recipe, only, dry_run, resume, skill_only,
name, capability=capability, recipe=recipe, only=only, resume=resume
)
if payload.get("error"):
+ track_matrix_install(
+ name,
+ scope=_matrix_scope_kind(capability, recipe, only),
+ status="usage_error" if payload.get("arg_error") else "error",
+ )
if as_json:
click.echo(json_mod.dumps({"error": payload["error"]}, indent=2))
else:
@@ -850,6 +894,21 @@ def matrix_install(name, capability, recipe, only, dry_run, resume, skill_only,
matrix_item = payload["matrix"]
summary = payload["summary"]
+ if summary["failed"]:
+ _install_status = "partial" if (summary["installed"] or summary["skipped"]) else "failed"
+ elif payload.get("nothing_to_resume"):
+ _install_status = "noop"
+ else:
+ _install_status = "ok"
+ track_matrix_install(
+ matrix_item["name"],
+ scope=_matrix_scope_kind(capability, recipe, only),
+ status=_install_status,
+ installed=summary["installed"],
+ skipped=summary["skipped"],
+ failed=summary["failed"],
+ )
+
if as_json:
data = {
"matrix": matrix_item["name"],
@@ -908,6 +967,8 @@ def matrix_doctor(name, as_json):
click.secho(f"✗ {payload['error']}", fg="red", err=True)
raise SystemExit(EXIT_FAIL)
+ track_matrix_info(payload["matrix"]["name"], kind="doctor")
+
if as_json:
data = {k: payload[k] for k in ("last_run", "checks", "summary")}
data["matrix"] = payload["matrix"]["name"]
@@ -941,6 +1002,7 @@ def matrix_doctor(name, as_json):
def matrix_recipes(query, as_json):
"""List task-oriented recipes across all matrices (F1.4)."""
recipes = all_recipes(query)
+ track_matrix_discover("recipes", query=query or "", results=len(recipes))
if as_json:
click.echo(json_mod.dumps({"query": query, "recipes": recipes}, indent=2))
diff --git a/cli-hub/setup.py b/cli-hub/setup.py
index 6274164ae..f942d9d75 100644
--- a/cli-hub/setup.py
+++ b/cli-hub/setup.py
@@ -50,7 +50,7 @@ class sdist(_sdist):
setup(
name="cli-anything-hub",
- version="0.3.0",
+ version="0.4.0",
description="Package manager for CLI-Anything — browse, install, and manage 40+ agent-native CLI interfaces for GUI applications",
long_description=open("README.md").read(),
long_description_content_type="text/markdown",