cade-cli 0.16.1__tar.gz → 0.16.2__tar.gz

{cade_cli-0.16.1 → cade_cli-0.16.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cade-cli
-Version: 0.16.1
+Version: 0.16.2
 Summary: Cade - The CLI Agent from Arcade.dev (install: curl -fsSL https://arcadeagent.dev/install | sh)
 Project-URL: Homepage, https://arcade.dev
 Project-URL: Documentation, https://arcadeagent.dev/docs
@@ -95,13 +95,13 @@ The CLI agent from [Arcade.dev](https://arcade.dev). Coding, research, and every
 
 ```bash
 curl -fsSL https://arcadeagent.dev/install | sh
-cade login
 cade
 ```
 
 That is the **recommended install** — a prebuilt binary from
 [arcadeagent.dev](https://arcadeagent.dev/install). No GitHub token, no Python
-toolchain. Re-run the same command to upgrade.
+toolchain. First `cade` walks you through model setup, Arcade login, and the
+[Arcade Agent Hub](https://hub.arcade.dev). Re-run the same curl to upgrade.
 
 ---
 
@@ -129,7 +129,7 @@ The script detects your OS/arch, downloads the matching prebuilt binary
 `~/.local/bin`. Pin a version or install location:
 
 ```bash
-CADE_VERSION=0.16.1 CADE_INSTALL_DIR=/usr/local/bin \
+CADE_VERSION=0.16.2 CADE_INSTALL_DIR=/usr/local/bin \
   sh -c "$(curl -fsSL https://arcadeagent.dev/install)"
 ```
 

{cade_cli-0.16.1 → cade_cli-0.16.2}/README.md

@@ -4,13 +4,13 @@ The CLI agent from [Arcade.dev](https://arcade.dev). Coding, research, and every
 
 ```bash
 curl -fsSL https://arcadeagent.dev/install | sh
-cade login
 cade
 ```
 
 That is the **recommended install** — a prebuilt binary from
 [arcadeagent.dev](https://arcadeagent.dev/install). No GitHub token, no Python
-toolchain. Re-run the same command to upgrade.
+toolchain. First `cade` walks you through model setup, Arcade login, and the
+[Arcade Agent Hub](https://hub.arcade.dev). Re-run the same curl to upgrade.
 
 ---
 
@@ -38,7 +38,7 @@ The script detects your OS/arch, downloads the matching prebuilt binary
 `~/.local/bin`. Pin a version or install location:
 
 ```bash
-CADE_VERSION=0.16.1 CADE_INSTALL_DIR=/usr/local/bin \
+CADE_VERSION=0.16.2 CADE_INSTALL_DIR=/usr/local/bin \
   sh -c "$(curl -fsSL https://arcadeagent.dev/install)"
 ```
 

{cade_cli-0.16.1 → cade_cli-0.16.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cade-cli"
-version = "0.16.1"
+version = "0.16.2"
 description = "Cade - The CLI Agent from Arcade.dev (install: curl -fsSL https://arcadeagent.dev/install | sh)"
 readme = "README.md"
 requires-python = ">=3.11"

{cade_cli-0.16.1 → cade_cli-0.16.2}/src/cadecoder/cli/app.py

@@ -304,7 +304,7 @@ def _doctor_paths(runtime: Any) -> dict[str, Any]:
     rich_help_panel=PANEL_SETUP,
 )
 def init_cmd() -> None:
-    from cadecoder.cli.onboarding import can_prompt, run_onboarding
+    from cadecoder.cli.onboarding import can_prompt, finish_first_run_cloud, run_onboarding
 
     if not can_prompt():
         console.print(
@@ -312,7 +312,11 @@ def init_cmd() -> None:
             "Set OPENAI_API_KEY or ANTHROPIC_API_KEY instead."
         )
         raise typer.Exit(1)
-    run_onboarding(console, force=True)
+    result = run_onboarding(console, force=True)
+    if result:
+        runtime = build_runtime()
+        set_runtime(runtime)
+        finish_first_run_cloud(console, prefer_skip_login=result.chose_local)
 
 
 @app.command(
@@ -484,11 +488,16 @@ def main_callback(
     # provider + model before we build the runtime, so the first session uses
     # what they chose (not the hardcoded default). No-ops when already set up or
     # when not attached to an interactive terminal (piped/CI).
-    from cadecoder.cli.onboarding import needs_onboarding, run_onboarding
-
-    did_onboard = False
+    from cadecoder.cli.onboarding import (
+        finish_first_run_cloud,
+        needs_onboarding,
+        run_onboarding,
+    )
+    from cadecoder.cli.onboarding import OnboardingResult
+
+    onboard_result = OnboardingResult()
     if needs_onboarding():
-        did_onboard = run_onboarding(console)
+        onboard_result = run_onboarding(console)
 
     # Interaction + runtime-backed commands run as the current agent, auto-creating
     # a `default` agent on first run via build_runtime → ensure_current_agent.
@@ -496,13 +505,10 @@ def main_callback(
     set_runtime(runtime)
     ctx.obj["runtime"] = runtime
 
-    # Right after first-run setup (runtime now available), offer to connect
-    # Arcade Omni so external tools work out of the box. No-op otherwise.
-    if did_onboard:
+    # After runtime is up: Arcade login (if needed) + Arcade Agent Hub connect.
+    if onboard_result:
         try:
-            from cadecoder.cli.commands.mcp import offer_connect_omni
-
-            offer_connect_omni(console)
+            finish_first_run_cloud(console, prefer_skip_login=onboard_result.chose_local)
         except Exception:  # noqa: BLE001
             pass
 

{cade_cli-0.16.1 → cade_cli-0.16.2}/src/cadecoder/cli/commands/auth.py

@@ -86,15 +86,15 @@ def login(
 
         log.info(f"User {whoami.email} logged in via OAuth.")
 
-        # Offer to connect Arcade Omni so the agent can use external tools
-        # (Gmail, Slack, web search, …) without a separate API key. No-op when
-        # non-interactive or already authorized.
+        # Offer to connect the Arcade Agent Hub so the agent can use external
+        # tools (Gmail, Slack, web search, …) without a separate API key.
+        # No-op when non-interactive or already authorized.
         try:
-            from cadecoder.cli.commands.mcp import offer_connect_omni
+            from cadecoder.cli.commands.mcp import offer_connect_hub
 
-            offer_connect_omni(console)
+            offer_connect_hub(console)
         except Exception as e:  # noqa: BLE001
-            log.debug(f"omni connect offer skipped: {e}")
+            log.debug(f"hub connect offer skipped: {e}")
 
     except OAuthLoginError as e:
         console.print(f"\n[red]✗ Login failed:[/red] {escape(str(e))}")

{cade_cli-0.16.1 → cade_cli-0.16.2}/src/cadecoder/cli/commands/mcp.py

@@ -372,22 +372,26 @@ def run_mcp_authorization(
     """Run the MCP OAuth authorization flow for a server. Returns success.
 
     If ``name`` isn't configured yet but is a built-in known server (e.g.
-    ``omni``), it's added in a disabled state first and only enabled once
+    ``hub``), it's added in a disabled state first and only enabled once
     authorization succeeds — so a cancelled/failed flow never leaves a broken
-    server that would error during chat.
+    server that would error during chat. The legacy name ``omni`` resolves to
+    the Arcade Agent Hub.
     """
     global _oauth_result
     _oauth_result = {"code": None, "error": None}
 
     store = MCPServerStore()
-    server = store.get(name)
+    # Resolve aliases (omni → hub) before looking up a stored config.
+    known = known_server_config(name)
+    lookup_name = known.name if known is not None else name
+    server = store.get(lookup_name) or store.get(name)
     if server is None:
-        server = known_server_config(name)
+        server = known
         if server is None:
             console.print(f"[red]Server '{name}' not found.[/red]")
             console.print(
                 "[dim]Add it with 'cade mcp add <name> <url>', "
-                "or authorize a known server like 'omni'.[/dim]"
+                "or authorize a known server like 'hub'.[/dim]"
             )
             return False
         store.add(server)  # persisted disabled; enabled on success
@@ -515,16 +519,17 @@ def run_mcp_authorization(
     return asyncio.run(run_oauth_flow())
 
 
-def offer_connect_omni(target_console: Console | None = None) -> None:
-    """Offer to connect Arcade Omni (external tools) if not already authorized.
+def offer_connect_hub(target_console: Console | None = None) -> None:
+    """Offer to connect the Arcade Agent Hub if not already authorized.
 
     Called after ``cade login`` and after first-run onboarding. No-op when the
-    terminal isn't interactive or when Omni is already authorized, so it never
-    blocks scripted/CI use.
+    terminal isn't interactive or when the Hub is already authorized, so it
+    never blocks scripted/CI use.
     """
     con = target_console or console
 
-    from cadecoder.cli.onboarding import can_prompt
+    from cadecoder.cli.onboarding import can_prompt, is_arcade_logged_in, offer_arcade_login
+    from cadecoder.tools.manager.config import HUB_SERVER_NAME
 
     if not can_prompt():
         return
@@ -534,30 +539,57 @@ def offer_connect_omni(target_console: Console | None = None) -> None:
     except Exception:  # noqa: BLE001
         return
 
-    existing = store.get("omni")
+    existing = store.get(HUB_SERVER_NAME) or store.get("omni")
     if existing is not None and existing.oauth_tokens is not None:
         return  # already connected
 
+    if not is_arcade_logged_in():
+        con.print()
+        con.print(
+            "[bold]Arcade login required[/bold] before connecting the "
+            "[cyan]Arcade Agent Hub[/cyan]."
+        )
+        if not offer_arcade_login(con, prefer_skip=False):
+            con.print(
+                "[dim]Skipped. Log in later with [bold]cade login[/bold], then "
+                "[bold]cade mcp authorize hub[/bold].[/dim]"
+            )
+            return
+
     from rich.prompt import Confirm
 
     con.print()
     con.print(
-        "[bold]Connect external tools?[/bold] Arcade [cyan]Omni[/cyan] lets Cade use "
-        "Gmail, Slack, GitHub, web search and more — authorized with your Arcade login "
-        "(no API key needed)."
+        "[bold]Connect external tools?[/bold] The [cyan]Arcade Agent Hub[/cyan] "
+        "([link=https://hub.arcade.dev]hub.arcade.dev[/link]) lets Cade use "
+        "Gmail, Slack, GitHub, web search and more — authorized with your Arcade "
+        "login (no API key needed)."
     )
     try:
-        proceed = Confirm.ask("Authorize Omni now? (opens your browser)", default=True, console=con)
+        proceed = Confirm.ask(
+            "Authorize Arcade Agent Hub now? (opens your browser)",
+            default=True,
+            console=con,
+        )
     except (KeyboardInterrupt, EOFError):
         con.print()
         return
 
     if not proceed:
-        con.print("[dim]Skipped. Connect anytime with [bold]cade mcp authorize omni[/bold].[/dim]")
+        con.print(
+            "[dim]Skipped. Connect anytime with [bold]cade mcp authorize hub[/bold].[/dim]"
+        )
         return
 
-    if not run_mcp_authorization("omni"):
-        con.print("[dim]You can retry later with [bold]cade mcp authorize omni[/bold].[/dim]")
+    if not run_mcp_authorization(HUB_SERVER_NAME):
+        con.print(
+            "[dim]You can retry later with [bold]cade mcp authorize hub[/bold].[/dim]"
+        )
+
+
+def offer_connect_omni(target_console: Console | None = None) -> None:
+    """Deprecated alias for :func:`offer_connect_hub`."""
+    offer_connect_hub(target_console)
 
 
 @mcp_app.command("authorize")
@@ -579,7 +611,7 @@ def authorize_server(
     """Authorize an MCP server over OAuth (browser flow).
 
     Works with any configured server, or a built-in known server by name
-    (e.g. ``cade mcp authorize omni`` to connect Arcade's external tools).
+    (e.g. ``cade mcp authorize hub`` to connect the Arcade Agent Hub).
     """
     if not run_mcp_authorization(name, client_id=client_id, scope=scope, skip_dcr=skip_dcr):
         raise typer.Exit(1)

{cade_cli-0.16.1 → cade_cli-0.16.2}/src/cadecoder/cli/onboarding.py

@@ -3,14 +3,18 @@
 A brand-new install has no obvious way to pick a model provider, and the silent
 provider fallback used to log a GPT model even when only an Anthropic key was
 set. This wizard runs once on first launch (and on demand via ``cade init``):
-it asks which provider to use, captures/stores an API key in the OS keyring,
-records a recommended default model, and writes the global config + default
-agent so the very first session uses exactly what the user chose.
+
+1. Model provider + API key + default model
+2. Arcade Cloud login (browser OAuth) — skipped only if the user opts out
+3. Arcade Agent Hub connect (after the runtime is up)
+
+Step 3 is :func:`finish_first_run_cloud` and must run after ``build_runtime``.
 """
 
 from __future__ import annotations
 
 import os
+from dataclasses import dataclass
 
 from rich.console import Console
 from rich.panel import Panel
@@ -28,6 +32,17 @@ _PROVIDER_LOCAL = "local"
 _KEYRING_SERVICE = "cade/model"
 
 
+@dataclass(frozen=True)
+class OnboardingResult:
+    """Outcome of the model-setup half of first-run onboarding."""
+
+    configured: bool = False
+    chose_local: bool = False
+
+    def __bool__(self) -> bool:
+        return self.configured
+
+
 def _marker_path():
     """Path to the sentinel that records onboarding has completed."""
     return get_paths().state_dir / "onboarded"
@@ -168,28 +183,170 @@ class OnboardingAborted(Exception):
     """Raised when the user cancels onboarding (Ctrl-C / empty required input)."""
 
 
-def run_onboarding(console: Console, *, force: bool = False) -> bool:
-    """Run the interactive setup wizard.
+def is_arcade_logged_in() -> bool:
+    """Return True when Arcade Cloud credentials are present and usable."""
+    try:
+        from cadecoder.cli.auth import check_existing_login
+
+        return check_existing_login(suppress_message=True)
+    except Exception:  # noqa: BLE001
+        return False
+
+
+def offer_arcade_login(console: Console, *, prefer_skip: bool = False) -> bool:
+    """Offer Arcade Cloud OAuth during first-run / init.
+
+    Args:
+        console: Rich console for prompts.
+        prefer_skip: When True (local model path), default the confirm to No.
+
+    Returns:
+        True if the user is logged in when this returns (already was, or just did).
+    """
+    if not can_prompt():
+        return is_arcade_logged_in()
+
+    if is_arcade_logged_in():
+        console.print()
+        console.print("[green]✓[/green] Already logged in to Arcade Cloud.")
+        return True
+
+    console.print()
+    console.print(
+        Panel.fit(
+            "[bold]Step 2 of 3 — Arcade Cloud[/bold]\n\n"
+            "Log in so Cade can use Gmail, Slack, GitHub, calendars, and the\n"
+            "rest of the Arcade catalogue. Opens your browser (free account).\n\n"
+            "[dim]Skip only if you want local tools + your model — nothing else.[/dim]",
+            border_style="cyan",
+        )
+    )
+    try:
+        proceed = Confirm.ask(
+            "Log in to Arcade Cloud now?",
+            default=not prefer_skip,
+            console=console,
+        )
+    except (KeyboardInterrupt, EOFError):
+        console.print()
+        proceed = False
+
+    if not proceed:
+        console.print(
+            "[dim]Skipped. Chat still works with your model and local tools.\n"
+            "Run [bold]cade login[/bold] anytime for cloud apps "
+            "(or [bold]cade --local-only[/bold] to stay offline).[/dim]"
+        )
+        return False
+
+    return try_interactive_login(console)
+
+
+def try_interactive_login(console: Console) -> bool:
+    """Run browser OAuth login; return True on success. Never raises Exit."""
+    from arcade_core.constants import PROD_COORDINATOR_HOST
+    from rich.markup import escape
+
+    from cadecoder.cli.auth import (
+        OAuthLoginError,
+        build_coordinator_url,
+        perform_oauth_login,
+        save_credentials_from_whoami,
+    )
+
+    try:
+        coordinator_url = build_coordinator_url(PROD_COORDINATOR_HOST, None)
+
+        def on_status(msg: str) -> None:
+            console.print(f"[dim]{msg}[/dim]")
+
+        tokens, whoami, client_id = perform_oauth_login(coordinator_url, on_status=on_status)
+        save_credentials_from_whoami(tokens, whoami, coordinator_url, client_id)
+        console.print("\n[green]✓ Login successful![/green]")
+        console.print(f"  Email: {whoami.email}")
+        org = whoami.get_selected_org()
+        project = whoami.get_selected_project()
+        if org and project:
+            console.print(
+                f"  Active: {org.get('name', 'unknown')} / {project.get('name', 'unknown')}"
+            )
+        return True
+    except OAuthLoginError as e:
+        console.print(f"\n[red]✗ Login failed:[/red] {escape(str(e))}")
+        console.print(
+            "[dim]Continue without cloud tools for now — "
+            "retry with [bold]cade login[/bold].[/dim]"
+        )
+        return False
+    except (KeyboardInterrupt, EOFError):
+        console.print("\n[yellow]Login cancelled.[/yellow]")
+        return False
+    except Exception as e:  # noqa: BLE001
+        console.print(f"\n[red]✗ Login failed:[/red] {escape(str(e))}")
+        console.print("[dim]Retry anytime with [bold]cade login[/bold].[/dim]")
+        return False
+
+
+def finish_first_run_cloud(console: Console, *, prefer_skip_login: bool = False) -> None:
+    """After runtime is ready: Arcade login (if needed), then Agent Hub connect.
+
+    Call this only after ``build_runtime()`` / ``set_runtime()`` so the Hub
+    MCP store can resolve the current agent.
+    """
+    if not can_prompt():
+        return
+
+    logged_in = offer_arcade_login(console, prefer_skip=prefer_skip_login)
+    if not logged_in:
+        return
+
+    try:
+        from cadecoder.cli.commands.mcp import offer_connect_hub
+
+        console.print()
+        console.print("[bold]Step 3 of 3 — Arcade Agent Hub[/bold] ([cyan]hub.arcade.dev[/cyan])")
+        offer_connect_hub(console)
+    except Exception:  # noqa: BLE001
+        console.print(
+            "[dim]Skipped Arcade Agent Hub. Connect later with "
+            "[bold]cade mcp authorize hub[/bold].[/dim]"
+        )
+
+
+def run_onboarding(console: Console, *, force: bool = False) -> OnboardingResult:
+    """Run the interactive model-setup wizard (step 1 of first-run).
 
     Args:
         console: Rich console (stderr) to render prompts on.
         force: Re-run even if already onboarded (``cade init``).
 
     Returns:
-        True if a provider was configured; False if skipped/aborted.
+        :class:`OnboardingResult` (truthy when a provider was configured).
+        Call :func:`finish_first_run_cloud` after the runtime is built for
+        steps 2–3 (login + Arcade Agent Hub).
     """
     if not force and not needs_onboarding():
-        return False
+        return OnboardingResult()
 
     if not can_prompt():
         # Non-interactive (piped/CI). Don't block; the provider error path will
         # guide the user if nothing is configured.
-        return False
+        return OnboardingResult()
 
     console.print(
         Panel.fit(
-            "Welcome to [bold]Cade[/bold] — let's pick a model provider.\n"
-            "You can change this anytime with [bold]cade init[/bold].",
+            "Welcome to [bold]Cade[/bold] — three quick steps:\n"
+            "  [bold]1.[/bold] Pick a model provider\n"
+            "  [bold]2.[/bold] Log in to Arcade Cloud (cloud apps)\n"
+            "  [bold]3.[/bold] Connect the Arcade Agent Hub\n\n"
+            "You can re-run this anytime with [bold]cade init[/bold].",
+            border_style="cyan",
+        )
+    )
+    console.print()
+    console.print(
+        Panel.fit(
+            "[bold]Step 1 of 3 — Model provider[/bold]",
             border_style="cyan",
         )
     )
@@ -238,10 +395,10 @@ def run_onboarding(console: Console, *, force: bool = False) -> bool:
         model = Prompt.ask("Model", default=default_model, console=console).strip() or default_model
     except (KeyboardInterrupt, EOFError):
         console.print("\n[yellow]Setup cancelled.[/yellow]")
-        return False
+        return OnboardingResult()
     except OnboardingAborted as e:
         console.print(f"[yellow]Setup cancelled: {e}[/yellow]")
-        return False
+        return OnboardingResult()
 
     _persist(
         provider=provider,
@@ -257,15 +414,16 @@ def run_onboarding(console: Console, *, force: bool = False) -> bool:
     console.print()
     console.print(
         Panel.fit(
-            f"[bold]You're set up.[/bold]\n"
+            f"[bold]Step 1 done.[/bold]\n"
             f"Model:    [cyan]{model}[/cyan]\n"
             f"Provider: [cyan]{label}[/cyan]\n\n"
-            "Change it later with [bold]cade init[/bold] or edit "
+            "Next: Arcade login + Arcade Agent Hub (cloud apps).\n"
+            "Change the model later with [bold]cade init[/bold] or edit "
             f"[dim]{get_paths().global_config}[/dim].",
             border_style="green",
         )
     )
-    return True
+    return OnboardingResult(configured=True, chose_local=(choice == "3"))
 
 
 def _persist(

{cade_cli-0.16.1 → cade_cli-0.16.2}/src/cadecoder/tools/manager/__init__.py

@@ -7,6 +7,8 @@ from cadecoder.tools.manager.base import (
 )
 from cadecoder.tools.manager.composite import CompositeToolManager
 from cadecoder.tools.manager.config import (
+    HUB_SERVER_NAME,
+    HUB_SERVER_URL,
     KNOWN_SERVERS,
     MCPAuthType,
     MCPOAuthTokens,
@@ -33,6 +35,8 @@ __all__ = [
     "MCPOAuthTokens",
     "MCPTransportType",
     # Known remote servers
+    "HUB_SERVER_NAME",
+    "HUB_SERVER_URL",
     "KNOWN_SERVERS",
     "known_server_config",
 ]

{cade_cli-0.16.1 → cade_cli-0.16.2}/src/cadecoder/tools/manager/config.py

@@ -126,9 +126,17 @@ class MCPServerConfig:
         if data.get("oauth_tokens"):
             oauth_tokens = MCPOAuthTokens.from_dict(data["oauth_tokens"])
 
+        name = data["name"]
+        url = data["url"]
+        # Migrate retired Omni endpoint → Arcade Agent Hub.
+        if isinstance(url, str) and "omni.arcade.dev" in url:
+            url = url.replace("omni.arcade.dev", "hub.arcade.dev")
+        if name == "omni":
+            name = "hub"
+
         return cls(
-            name=data["name"],
-            url=data["url"],
+            name=name,
+            url=url,
             transport=MCPTransportType(data.get("transport", "http")),
             auth_type=MCPAuthType(data.get("auth_type") or data.get("auth", "none")),
             auth_value=data.get("auth_value"),
@@ -149,31 +157,43 @@ class MCPServerConfig:
 
 # Built-in, well-known remote MCP servers a user can connect with one command
 # (`cade mcp authorize <name>`). They are *not* added to an agent until the user
-# authorizes them, so they never break a fresh install. Omni is Arcade's
-# meta-discovery server: once authorized over OAuth it exposes the whole Arcade
-# tool catalog (Gmail, Slack, GitHub, web search, …) via SelectTools/UseTool —
-# no ARCADE_API_KEY required (auth rides the user's Arcade login).
+# authorizes them, so they never break a fresh install. The Arcade Agent Hub
+# (`hub.arcade.dev`) is Arcade's meta-discovery server: once authorized over
+# OAuth it exposes the whole Arcade tool catalog (Gmail, Slack, GitHub, web
+# search, …) via SelectTools/UseTool — no ARCADE_API_KEY required (auth rides
+# the user's Arcade login).
+HUB_SERVER_NAME = "hub"
+HUB_SERVER_URL = "https://hub.arcade.dev/mcp"
+
 KNOWN_SERVERS: dict[str, dict[str, str]] = {
-    "omni": {
-        "url": "https://omni.arcade.dev/mcp",
+    HUB_SERVER_NAME: {
+        "url": HUB_SERVER_URL,
         "description": (
-            "Arcade Omni — discover & run external tools (Gmail, Slack, GitHub, web search, …)"
+            "Arcade Agent Hub — discover & run external tools "
+            "(Gmail, Slack, GitHub, web search, …)"
         ),
     },
 }
 
+# Retired name → canonical known-server name (authorize / list still accept it).
+_KNOWN_SERVER_ALIASES: dict[str, str] = {
+    "omni": HUB_SERVER_NAME,
+}
+
 
 def known_server_config(name: str) -> "MCPServerConfig | None":
     """Return a fresh, disabled OAuth config for a built-in known server.
 
     Disabled by default so it is only connected after a successful
-    ``cade mcp authorize <name>`` (which flips ``enabled`` on).
+    ``cade mcp authorize <name>`` (which flips ``enabled`` on). The legacy
+    name ``omni`` resolves to the Arcade Agent Hub (``hub``).
     """
-    info = KNOWN_SERVERS.get(name)
+    canonical = _KNOWN_SERVER_ALIASES.get(name, name)
+    info = KNOWN_SERVERS.get(canonical)
     if info is None:
         return None
     return MCPServerConfig(
-        name=name,
+        name=canonical,
         url=info["url"],
         transport=MCPTransportType.HTTP,
         auth_type=MCPAuthType.OAUTH,