cade-cli 0.17.0__tar.gz → 0.18.0__tar.gz

{cade_cli-0.17.0 → cade_cli-0.18.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cade-cli
-Version: 0.17.0
+Version: 0.18.0
 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
@@ -104,7 +104,7 @@ toolchain. First `cade` walks you through model setup, Arcade login, and
 Arcade cloud tools. Re-run the same curl to upgrade.
 
 New here? The [Quickstart](docs/quickstart.md) is the shortest path to a
-working session; [Use Cade in Cursor](docs/use-in-cursor.md) is the same thing
+working session; [Connect Cade to your AI app](docs/use-in-cursor.md) is the same thing
 without a terminal. Everything else is in [docs/](docs/index.md).
 
 ---

{cade_cli-0.17.0 → cade_cli-0.18.0}/README.md

@@ -13,7 +13,7 @@ toolchain. First `cade` walks you through model setup, Arcade login, and
 Arcade cloud tools. Re-run the same curl to upgrade.
 
 New here? The [Quickstart](docs/quickstart.md) is the shortest path to a
-working session; [Use Cade in Cursor](docs/use-in-cursor.md) is the same thing
+working session; [Connect Cade to your AI app](docs/use-in-cursor.md) is the same thing
 without a terminal. Everything else is in [docs/](docs/index.md).
 
 ---

{cade_cli-0.17.0 → cade_cli-0.18.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cade-cli"
-version = "0.17.0"
+version = "0.18.0"
 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.17.0 → cade_cli-0.18.0}/src/cadecoder/cli/commands/daemon.py

@@ -6,7 +6,6 @@ One process serves every agent to MCP hosts and messaging adapters.
 from __future__ import annotations
 
 import asyncio
-import json
 import os
 import signal
 import sys
@@ -110,7 +109,7 @@ def start(
         typer.Option(
             "--auth/--no-auth",
             help=(
-                "Require bearer tokens. Default: off on loopback (stdio MCP hosts / "
+                "Require bearer tokens. Default: off on loopback (local MCP hosts / "
                 "CLI attach), on for non-loopback binds. --no-auth is refused off-loopback."
             ),
         ),
@@ -175,7 +174,15 @@ def status(
         if prewarm:
             console.print(f"  prewarmed agents: {', '.join(prewarm)}")
     else:
-        console.print("[dim]○ cade daemon NOT RUNNING[/dim]  (start: cade daemon start)")
+        # Someone checking status is usually here because an MCP host could not
+        # reach Cade, and hosts cannot start it — so name the fix that keeps it
+        # up rather than `start`, which only holds the current terminal. With a
+        # unit already installed, `start` would also spawn a second daemon
+        # outside the service manager; restart drives the unit instead.
+        from cadecoder.daemon.install import service_install_hint, service_installed
+
+        fix = "cade daemon restart" if service_installed() else service_install_hint()
+        console.print(f"[dim]○ cade daemon NOT RUNNING[/dim]  (start: {fix})")
 
     store = TokenStore()
     try:
@@ -354,17 +361,18 @@ def init(
 
 def _host_config_json() -> str:
     """Return the MCP-host JSON snippet for a manually configured host."""
-    from cadecoder.cli.mcp_hosts import http_entry
+    from cadecoder.cli.mcp_hosts import client_recipe
 
-    return json.dumps({"mcpServers": {"cade": http_entry()}}, indent=2)
+    return client_recipe("generic").to_json()
 
 
 def _report_mcp_hosts(*, print_config: bool) -> None:
     """Tell the user how their MCP hosts get configured.
 
-    Autodetection handles Cursor, Claude Desktop, Claude Code, OpenCode, and
-    Windsurf, so the JSON snippet is a fallback for hosts we cannot find (or
-    for anyone who explicitly asked for it), not the headline instruction.
+    Autodetection handles Cursor, Claude Desktop, Claude Code, OpenCode,
+    Windsurf, and VS Code, so the JSON snippet is a fallback for hosts we
+    cannot find (or for anyone who explicitly asked for it), not the headline
+    instruction. ``cade mcp config <app>`` gives per-app variants.
 
     Args:
         print_config: Force the raw JSON snippet to be shown.
@@ -396,7 +404,7 @@ def _report_mcp_hosts(*, print_config: bool) -> None:
     else:
         console.print(
             "\n[yellow]No MCP hosts detected[/yellow] "
-            "(looked for Cursor, Claude Desktop, Claude Code, OpenCode, Windsurf)."
+            "(looked for Cursor, Claude Desktop, Claude Code, OpenCode, Windsurf, VS Code)."
         )
         console.print(
             "Install one and run [bold]cade mcp install-hosts[/bold], or add this "

{cade_cli-0.17.0 → cade_cli-0.18.0}/src/cadecoder/cli/commands/mcp.py

@@ -694,9 +694,10 @@ def install_hosts_cmd(
 ) -> None:
     """Register Cade as an MCP server and install the host plugin.
 
-    Points Cursor, Claude Code, OpenCode, and Windsurf at the daemon's HTTP
-    endpoint; Claude Desktop gets an ``npx mcp-remote`` bridge because its
-    config file only accepts stdio entries. Also materializes a
+    Points Cursor, Claude Code, OpenCode, Windsurf, and VS Code (Copilot) at
+    the daemon's HTTP endpoint; Claude Desktop gets an ``npx mcp-remote``
+    bridge because its config file only accepts stdio entries. For an app that
+    is not detected, ``cade mcp config <app>`` prints what to paste. Also materializes a
     marketplace-shaped plugin at ``~/.cade/host-plugin`` and
     ``~/.cursor/plugins/local/cade`` (plus Claude Code user skills).
 
@@ -721,12 +722,12 @@ def install_hosts_cmd(
     if not updates and all(u.status == "skipped" for u in plugin_updates):
         console.print(
             "[dim]No MCP hosts detected (looked for Cursor, Claude Desktop, "
-            "Claude Code, OpenCode, Windsurf).[/dim]"
+            "Claude Code, OpenCode, Windsurf, VS Code).[/dim]"
         )
         console.print(
             "[dim]After installing a host, re-run [bold]cade mcp install-hosts[/bold] — "
-            "it writes each host's config for you. For a host Cade cannot detect, "
-            "[bold]cade daemon init --print-config[/bold] prints the JSON to add by hand.[/dim]"
+            "it writes each host's config for you. For an app Cade cannot detect "
+            "(Cowork, for one), [bold]cade mcp config <app>[/bold] prints what to paste.[/dim]"
         )
         return
 
@@ -768,11 +769,48 @@ def install_hosts_cmd(
         console.print("  2. Reload Cursor/Claude (quit and reopen, or Developer: Reload Window)")
         console.print("  3. In chat: [bold]Ask Cade to say hello[/bold]")
         console.print("  4. Check: [bold]cade doctor[/bold]")
-        console.print("[dim]Guide: docs → Use Cade in Cursor[/dim]")
+        console.print("[dim]Guide: https://arcadeagent.dev/docs/use-in-cursor/[/dim]")
     else:
         console.print(f"\n[dim]Dry run — {changed} change(s) would apply.[/dim]")
 
 
+@mcp_app.command("config", rich_help_panel=PANEL_HOSTS)
+def config_cmd(
+    client: Annotated[
+        str,
+        typer.Argument(
+            help="Which app: generic, cowork, vscode (or copilot), claude-desktop.",
+        ),
+    ] = "generic",
+) -> None:
+    """Print the config to paste into an AI app Cade cannot set up itself.
+
+    `cade mcp install-hosts` handles Cursor, Claude Code, Claude Desktop,
+    OpenCode, Windsurf, and VS Code. Use this for anything else — Cowork, whose
+    config is per-project, or an app that was not detected.
+    """
+    from cadecoder.cli.mcp_hosts import CLIENT_NAMES, client_recipe
+    from cadecoder.daemon.services import gateway_endpoint, read_gateway_manifest
+
+    try:
+        recipe = client_recipe(client, endpoint=gateway_endpoint())
+    except KeyError:
+        fail(f"Unknown app '{client}'. Try one of: {', '.join(CLIENT_NAMES)}")
+        return
+
+    console.print(f"[bold]{recipe.label}[/bold] [dim]— add to {recipe.where}[/dim]\n")
+    console.print(recipe.to_json())
+    if recipe.note:
+        console.print(f"\n[dim]{recipe.note}[/dim]")
+    # The URL above is only reachable if something is serving it, and no app
+    # starts Cade on its own — so a snippet without a daemon is a dead end.
+    if read_gateway_manifest() is None:
+        from cadecoder.daemon.install import service_install_hint, service_installed
+
+        fix = "cade daemon restart" if service_installed() else service_install_hint()
+        console.print(f"\n[yellow]Cade is not running[/yellow] [dim]— start it with: {fix}[/dim]")
+
+
 @mcp_app.command("token-info", rich_help_panel=PANEL_HOSTS)
 def token_info(
     name: Annotated[str, typer.Argument(help="Name of the server")],

{cade_cli-0.17.0 → cade_cli-0.18.0}/src/cadecoder/cli/mcp_hosts.py

@@ -1,7 +1,7 @@
 """Register Cade as an MCP server in detected AI host apps.
 
 Scans typical home-directory config locations for Claude Desktop, Cursor,
-Claude Code, OpenCode, and Windsurf. When a host's config dir (or file)
+Claude Code, OpenCode, Windsurf, and VS Code (Copilot). When a host's config dir (or file)
 already exists, merges a ``cade`` entry pointing at the daemon's Streamable
 HTTP endpoint, so no per-host process is involved.
 
@@ -45,6 +45,7 @@ class HostKind(str, Enum):
     CLAUDE_DESKTOP = "claudeDesktop"  # mcpServers, but stdio-only — needs a bridge
     OPENCODE = "opencode"  # OpenCode ``mcp`` map with type/url
     WINDSURF = "windsurf"  # Windsurf mcp_config.json
+    VSCODE = "vscode"  # VS Code / Copilot — root key ``servers``, explicit ``type``
 
 
 @dataclass(frozen=True)
@@ -139,6 +140,100 @@ def opencode_entry(*, endpoint: str | None = None) -> dict[str, Any]:
     }
 
 
+def vscode_entry(*, endpoint: str | None = None) -> dict[str, Any]:
+    """VS Code / Copilot ``servers.<name>`` entry.
+
+    Unlike every other host here, VS Code will not infer the transport: a block
+    without an explicit ``type`` is invalid and Copilot drops it with only a
+    line in an output channel, so the tool silently never appears.
+    """
+    return {"type": "http", "url": endpoint or gateway_endpoint()}
+
+
+@dataclass(frozen=True)
+class ClientRecipe:
+    """A paste-ready MCP config for a client Cade cannot configure itself."""
+
+    label: str
+    config: dict[str, Any]
+    where: str
+    note: str = ""
+
+    def to_json(self) -> str:
+        """The snippet, formatted the way it should appear in the file."""
+        return json.dumps(self.config, indent=2)
+
+
+def client_recipe(client: str, *, endpoint: str | None = None) -> ClientRecipe:
+    """Config snippet plus where it goes, for one MCP client.
+
+    Covers the clients that ``install-hosts`` cannot write for itself — either
+    because their config is per-project (Cowork) or because the user is pasting
+    into an app we do not detect.
+
+    Args:
+        client: One of ``cowork``, ``vscode``/``copilot``, ``claude-desktop``,
+            or ``generic``.
+        endpoint: Gateway URL to embed. Defaults to the running daemon's.
+
+    Returns:
+        The recipe for that client.
+
+    Raises:
+        KeyError: If ``client`` is not a known name.
+
+    Example:
+        >>> client_recipe("cowork").config["mcpServers"]["cade"]["type"]
+        'streamable-http'
+    """
+    url = endpoint or gateway_endpoint()
+    key = client.strip().lower()
+    if key in ("vscode", "copilot", "vs-code"):
+        return ClientRecipe(
+            label="VS Code / GitHub Copilot",
+            config={"servers": {SERVER_KEY: vscode_entry(endpoint=url)}},
+            where="Command Palette → 'MCP: Open User Configuration', "
+            "or .vscode/mcp.json in your project",
+            note="VS Code keys this 'servers', not 'mcpServers', and needs the "
+            "explicit 'type'. Copilot must be in Agent mode to use tools.",
+        )
+    if key == "cowork":
+        # Cowork's sandbox reaches tools only over HTTP, which is what the
+        # gateway already speaks — so unlike a stdio server it needs no bridge.
+        return ClientRecipe(
+            label="Claude Cowork",
+            config={
+                "mcpServers": {
+                    SERVER_KEY: {"type": "streamable-http", "url": url},
+                }
+            },
+            where=".mcp.json in your project directory",
+            note="Start a new Cowork session afterwards. If it cannot reach "
+            "this address, its sandbox is isolated from your machine — bind "
+            "Cade to a reachable address with a token instead.",
+        )
+    if key in ("claude-desktop", "claudedesktop"):
+        return ClientRecipe(
+            label="Claude Desktop",
+            config={"mcpServers": {SERVER_KEY: mcp_remote_entry(endpoint=url)}},
+            where="claude_desktop_config.json",
+            note="Claude Desktop accepts stdio entries only, so this goes "
+            "through a bridge and needs Node.js 18+. 'cade mcp install-hosts' "
+            "writes it for you.",
+        )
+    if key == "generic":
+        return ClientRecipe(
+            label="Most MCP clients",
+            config={"mcpServers": {SERVER_KEY: {"type": "http", "url": url}}},
+            where="your app's MCP config file",
+            note="Restart the app afterwards — most read their config only at startup.",
+        )
+    raise KeyError(client)
+
+
+CLIENT_NAMES = ("generic", "cowork", "vscode", "claude-desktop")
+
+
 def discover_hosts(home: Path | None = None) -> list[HostTarget]:
     """Return host configs that look installed (marker path exists)."""
     home = home or Path.home()
@@ -223,6 +318,25 @@ def discover_hosts(home: Path | None = None) -> list[HostTarget]:
         )
     )
 
+    # VS Code (GitHub Copilot). User-profile config, so it applies to every
+    # workspace; the per-workspace `.vscode/mcp.json` is the user's to manage.
+    for label, folder in (("VS Code", "Code"), ("VS Code Insiders", "Code - Insiders")):
+        if system == "Darwin":
+            user_dir = home / "Library" / "Application Support" / folder / "User"
+        elif system == "Windows":
+            appdata = os.environ.get("APPDATA", str(home / "AppData" / "Roaming"))
+            user_dir = Path(appdata) / folder / "User"
+        else:
+            user_dir = home / ".config" / folder / "User"
+        targets.append(
+            HostTarget(
+                name=label,
+                path=user_dir / "mcp.json",
+                kind=HostKind.VSCODE,
+                marker=user_dir,
+            )
+        )
+
     return [t for t in targets if t.marker.exists()]
 
 
@@ -322,6 +436,27 @@ def _merge_opencode(
     return data, "added" if existing is None else "updated"
 
 
+def _merge_vscode(
+    data: dict[str, Any],
+    entry: dict[str, Any],
+    *,
+    force: bool,
+) -> tuple[dict[str, Any], str]:
+    """Merge into VS Code's ``servers`` map (not ``mcpServers``)."""
+    del force  # same reasoning as _merge_mcp_servers: always take the new entry
+    servers = data.get("servers")
+    if servers is None:
+        servers = {}
+        data["servers"] = servers
+    if not isinstance(servers, dict):
+        raise ValueError("servers must be an object")
+    existing = servers.get(SERVER_KEY)
+    if existing == entry:
+        return data, "unchanged"
+    servers[SERVER_KEY] = entry
+    return data, "added" if existing is None else "updated"
+
+
 def _merge_windsurf(
     data: dict[str, Any],
     entry: dict[str, Any],
@@ -346,6 +481,9 @@ def register_host(
         if target.kind == HostKind.OPENCODE:
             entry = opencode_entry(endpoint=url)
             data, status = _merge_opencode(data, entry, force=force)
+        elif target.kind == HostKind.VSCODE:
+            entry = vscode_entry(endpoint=url)
+            data, status = _merge_vscode(data, entry, force=force)
         elif target.kind == HostKind.CLAUDE_DESKTOP:
             entry = mcp_remote_entry(endpoint=url)
             data, status = _merge_mcp_servers(data, entry, force=force)
@@ -395,4 +533,5 @@ __all__ = [
     "mcp_remote_entry",
     "opencode_entry",
     "register_host",
+    "vscode_entry",
 ]

{cade_cli-0.17.0 → cade_cli-0.18.0}/src/cadecoder/cli/onboarding.py

@@ -337,7 +337,7 @@ def finish_first_run_cloud(console: Console, *, prefer_skip_login: bool = False)
             console.print(
                 f"\n[yellow]Could not update:[/yellow] {names}\n"
                 "[dim]Retry with [bold]cade mcp install-hosts --force[/bold], or see the "
-                "config to add by hand with [bold]cade daemon init --print-config[/bold].[/dim]"
+                "config to add by hand with [bold]cade mcp config <app>[/bold].[/dim]"
             )
         if plugin_touched:
             migrated_n = sum(1 for u in plugin_touched if u.status == "migrated")

{cade_cli-0.17.0 → cade_cli-0.18.0}/src/cadecoder/daemon/server.py

@@ -46,7 +46,7 @@ def resolve_require_auth(*, bind: str, auth: bool | None) -> bool:
     """Decide whether the gateway should require bearer tokens.
 
     When ``auth`` is ``None`` (CLI default), loopback binds run unauthenticated
-    so stdio MCP hosts and CLI attach work without a token; non-loopback binds
+    so local MCP hosts and CLI attach work without a token; non-loopback binds
     require auth. Explicit ``--auth`` / ``--no-auth`` always win (subject to
     :func:`_guard_auth_bind`).
     """

{cade_cli-0.17.0 → cade_cli-0.18.0}/src/cadecoder/host_plugin/assets/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "cade",
   "description": "Your persistent on-device agent: notes memory, durable tasks, and connected tools via Ask.",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "author": {
     "name": "Arcade.dev",
     "url": "https://docs.cade.dev"

{cade_cli-0.17.0 → cade_cli-0.18.0}/src/cadecoder/host_plugin/assets/.cursor-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "cade",
   "displayName": "Cade",
   "description": "Your persistent on-device agent: notes memory, durable tasks, and connected tools via Ask.",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "author": {
     "name": "Arcade.dev",
     "email": "support@arcade.dev"