Distinguish Iris dashboard titles

yonromai · yonromai · commit 0c6ddf6a9ac2 · 2026-04-24T19:47:08.000-07:00
diff --git a/lib/iris/dashboard/src/template.html b/lib/iris/dashboard/src/template.html
@@ -12,6 +12,15 @@
           document.documentElement.classList.add('dark');
         }
       } catch(e) {}
+
+      try {
+        var params = new URLSearchParams(window.location.search);
+        var dashboardTitle = (params.get('iris_title') || sessionStorage.getItem('iris-title') || '').trim();
+        if (dashboardTitle) {
+          sessionStorage.setItem('iris-title', dashboardTitle);
+          document.title = dashboardTitle + ' | Iris';
+        }
+      } catch(e) {}
     </script>
   </head>
   <body class="bg-surface text-text font-sans antialiased">
diff --git a/lib/iris/src/iris/cli/cluster.py b/lib/iris/src/iris/cli/cluster.py
@@ -20,7 +20,7 @@
     find_marin_root,
     get_git_sha,
 )
-from iris.cli.main import IRIS_CLUSTER_CONFIG_DIRS, require_controller_url, rpc_client
+from iris.cli.main import IRIS_CLUSTER_CONFIG_DIRS, dashboard_url, require_controller_url, rpc_client
 from iris.cluster.config import IrisConfig, clear_remote_state, make_local_config
 from iris.cluster.controller.autoscaler.scaling_group import (
     build_worker_config_for_group,
@@ -267,11 +267,13 @@ def cluster_start(ctx, local: bool, fresh: bool):
             cluster = LocalCluster(config)
             address = cluster.start()
             click.echo(f"Controller started at {address}")
+            title_url = dashboard_url(address, ctx.obj.get("cluster_name"))
             token = cluster.auto_login_token
             if token:
-                click.echo(f"Dashboard: {address}?session_token={token}")
+                separator = "&" if "?" in title_url else "?"
+                click.echo(f"Dashboard: {title_url}{separator}session_token={token}")
             else:
-                click.echo(f"Dashboard: {address}")
+                click.echo(f"Dashboard: {title_url}")
             click.echo("\nController is running with integrated autoscaler.")
             click.echo("Press Ctrl+C to stop.")
             if threading.current_thread() is threading.main_thread():
@@ -567,7 +569,7 @@ def on_signal(sig, frame):
     signal.signal(signal.SIGINT, on_signal)
     signal.signal(signal.SIGTERM, on_signal)
 
-    click.echo(f"\nDashboard:      {controller_url}")
+    click.echo(f"\nDashboard:      {dashboard_url(controller_url, ctx.obj.get('cluster_name'))}")
     click.echo(f"Controller RPC: {controller_url}")
     click.echo("\nPress Ctrl+C to close tunnel.")
     stop.wait()
diff --git a/lib/iris/src/iris/cli/main.py b/lib/iris/src/iris/cli/main.py
@@ -9,6 +9,7 @@
 import logging as _logging_module
 import sys
 from pathlib import Path
+from urllib.parse import parse_qsl, urlencode, urlsplit, urlunsplit
 
 import click
 
@@ -82,6 +83,18 @@ def resolve_cluster_name(
     return "default"
 
 
+def dashboard_url(controller_url: str, cluster_name: str | None) -> str:
+    """Return a dashboard URL that lets the frontend set a cluster-specific tab title."""
+    name = (cluster_name or "").strip()
+    if not name:
+        return controller_url
+    parsed = urlsplit(controller_url)
+    query = [(key, value) for key, value in parse_qsl(parsed.query, keep_blank_values=True) if key != "iris_title"]
+    query.append(("iris_title", name))
+    path = parsed.path or "/"
+    return urlunsplit((parsed.scheme, parsed.netloc, path, urlencode(query), parsed.fragment))
+
+
 def create_client_token_provider(
     auth_config: config_pb2.AuthConfig, cluster_name: str = "default"
 ) -> TokenProvider | None:
