release v0.5.1 at 2026-06-22 20:15:55 UTC

sushicw · sushicw · commit 7e1f009ab528 · 2026-06-22T20:15:55.000Z
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "google-agents-cli",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Scaffold, develop, evaluate, and deploy AI agents with Google ADK. Bundles 7 skills for the agent development lifecycle.",
   "author": { "name": "Google LLC" },
   "homepage": "https://github.com/google/agents-cli",
diff --git a/README.md b/README.md
@@ -164,7 +164,7 @@ We value your input — it helps us improve `agents-cli` for the community.
 
 ## Contributing
 
-The best way to contribute is through feedback: bug reports, feature requests, and ideas shared via [issues](https://github.com/google/agents-cli/issues) to directly shape our roadmap. The CLI is distributed as a pre-built wheel rather than as source in the repository, which lets us iterate quickly while keeping the public interface stable. The code is not obfuscated — you can inspect any release by extracting the `.whl` file (a standard zip archive).
+The best way to contribute is through feedback: bug reports, feature requests, and ideas shared via [issues](https://github.com/google/agents-cli/issues) to directly shape our roadmap.
 
 See the [contributing guide](CONTRIBUTING.md) for details.
 
diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
@@ -2,6 +2,14 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.5.1] - 2026-06-18
+- Fixed run and playground commands on Windows
+  - https://github.com/google/agents-cli/issues/34
+  - https://github.com/google/agents-cli/issues/35
+  - Thanks to @Abdullah-k0de for discovering and reporting these!
+- Fixed stale GCS bucket in failure-investigation guide
+- Added Agent Registry fleet management to publish skill
+
 ## [0.5.0] - 2026-06-15
 - `deploy` now surfaces machine-shape parameters as flags for Agent Runtime and Cloud Run.
 - `deploy` adds a `--service-name` override.
diff --git a/docs/src/reference/about.md b/docs/src/reference/about.md
@@ -9,4 +9,4 @@ We value your input — it helps us improve `agents-cli` for the community.
 
 ## Contributing
 
-The best way to contribute is through feedback: bug reports, feature requests, and ideas shared via [issues](https://github.com/google/agents-cli/issues) to directly shape our roadmap. The CLI is distributed as a pre-built wheel rather than as source in the repository, which lets us iterate quickly while keeping the public interface stable. The code is not obfuscated — you can inspect any release by extracting the `.whl` file (a standard zip archive).
+The best way to contribute is through feedback: bug reports, feature requests, and ideas shared via [issues](https://github.com/google/agents-cli/issues) to directly shape our roadmap.
diff --git a/gemini-extension.json b/gemini-extension.json
@@ -1,5 +1,5 @@
 {
   "name": "google-agents-cli",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Scaffold, develop, evaluate, and deploy AI agents with Google ADK. Bundles 7 skills for the agent development lifecycle."
 }
diff --git a/skills/google-agents-cli-adk-code/SKILL.md b/skills/google-agents-cli-adk-code/SKILL.md
@@ -12,7 +12,7 @@ description: >
 metadata:
   author: Google
   license: Apache-2.0
-  version: 0.5.0
+  version: 0.5.1
   requires:
     bins:
       - agents-cli
diff --git a/skills/google-agents-cli-deploy/SKILL.md b/skills/google-agents-cli-deploy/SKILL.md
@@ -12,7 +12,7 @@ description: >
 metadata:
   author: Google
   license: Apache-2.0
-  version: 0.5.0
+  version: 0.5.1
   requires:
     bins:
       - agents-cli
diff --git a/skills/google-agents-cli-eval/SKILL.md b/skills/google-agents-cli-eval/SKILL.md
@@ -11,7 +11,7 @@ description: >
 metadata:
   author: Google
   license: Apache-2.0
-  version: 0.5.0
+  version: 0.5.1
   requires:
     bins:
       - agents-cli
diff --git a/skills/google-agents-cli-observability/SKILL.md b/skills/google-agents-cli-observability/SKILL.md
@@ -13,7 +13,7 @@ description: >
 metadata:
   author: Google
   license: Apache-2.0
-  version: 0.5.0
+  version: 0.5.1
   requires:
     bins:
       - agents-cli
diff --git a/skills/google-agents-cli-publish/SKILL.md b/skills/google-agents-cli-publish/SKILL.md
@@ -5,14 +5,17 @@ description: >
   "publish my ADK agent", "register an agent with Gemini Enterprise",
   "publish to Gemini Enterprise", or needs guidance on the agents-cli
   publish gemini-enterprise command.
+  Also use when the user wants to "manage agents in Agent Registry" or
+  "list/update/delete registered agents".
   Covers ADK vs A2A registration modes, programmatic and interactive usage,
-  flag reference, auto-detection from deployment metadata, and troubleshooting.
+  flag reference, auto-detection from deployment metadata, Agent Registry
+  fleet management, and troubleshooting.
   Part of the Google ADK (Agent Development Kit) skills suite.
   Do NOT use for deployment (use google-agents-cli-deploy).
 metadata:
   author: Google
   license: Apache-2.0
-  version: 0.5.0
+  version: 0.5.1
   requires:
     bins:
       - agents-cli
@@ -154,6 +157,35 @@ Agent Runtime deployments may encounter "Session not found" errors with `google-
 
 ---
 
+## Managing Agents in Agent Registry
+
+Agent Registry (Preview) is the Google Cloud fleet-wide record of your agents.
+Agents deployed to a managed runtime (Agent Runtime on Gemini Enterprise
+Agent Platform) are **auto-registered** — no extra step after `agents-cli deploy`.
+Manage them with `gcloud` (requires `roles/agentregistry.editor`):
+
+```bash
+# List / filter
+gcloud alpha agent-registry agents list --project PROJECT --location LOCATION
+gcloud alpha agent-registry agents list --filter="displayName:my-agent"
+
+# Inspect
+gcloud alpha agent-registry agents describe AGENT_NAME
+
+# Update endpoint/metadata — edit the Service resource, not the Agent
+gcloud alpha agent-registry services update AGENT_NAME \
+  --display-name "..." --description "..." \
+  --interfaces "url=ENDPOINT_URL,protocol=HTTP_JSON"
+
+# Remove: delete the underlying runtime agent (auto-registered) OR, for
+# manually registered agents, delete the Service resource
+gcloud alpha agent-registry services delete AGENT_NAME
+```
+
+Docs: https://docs.cloud.google.com/agent-registry/manage-agents
+
+---
+
 ## Troubleshooting
 
 | Issue | Solution |
diff --git a/skills/google-agents-cli-scaffold/SKILL.md b/skills/google-agents-cli-scaffold/SKILL.md
@@ -12,7 +12,7 @@ description: >
 metadata:
   author: Google
   license: Apache-2.0
-  version: 0.5.0
+  version: 0.5.1
   requires:
     bins:
       - agents-cli
diff --git a/skills/google-agents-cli-workflow/SKILL.md b/skills/google-agents-cli-workflow/SKILL.md
@@ -12,7 +12,7 @@ description: >
 metadata:
   author: Google
   license: Apache-2.0
-  version: 0.5.0
+  version: 0.5.1
   requires:
     bins:
       - agents-cli
@@ -26,8 +26,8 @@ metadata:
 **agents-cli** is a CLI and skills toolkit for building, evaluating, and deploying agents on Google Cloud using the [Agent Development Kit (ADK)](https://adk.dev/). It works with any coding agent — Gemini CLI, Claude Code, Codex, or others. Install with `uvx google-agents-cli setup`.
 
 
-> Requires: google-agents-cli ~= 0.5.0
-> If version is behind, run: uv tool install "google-agents-cli~=0.5.0"
+> Requires: google-agents-cli ~= 0.5.1
+> If version is behind, run: uv tool install "google-agents-cli~=0.5.1"
 
 > Check version: agents-cli info
 > [Install uv](https://docs.astral.sh/uv/getting-started/installation/index.md) first if needed.
diff --git a/src/google/agents/cli/_runner.py b/src/google/agents/cli/_runner.py
@@ -152,3 +152,43 @@ def popen_resolved(
         args[0] = _tools.require_tool(executable)
 
     return subprocess.Popen(args, **kwargs)
+
+
+def popen_resolved_detached(
+    args: list[str], *, resolve_executable: bool = True, **kwargs
+) -> subprocess.Popen:
+    """Wrapper around subprocess.Popen for launching detached background processes.
+
+    Handles cross-platform differences for process detaching:
+    - On POSIX, sets start_new_session=True.
+    - On Windows, sets creationflags to DETACHED_PROCESS and CREATE_NEW_PROCESS_GROUP.
+    - Ensures stdin is redirected to subprocess.DEVNULL.
+
+    Args:
+        args: Command and arguments as a list of strings.
+        resolve_executable: If True, resolve the executable path using require_tool.
+            Defaults to True.
+        **kwargs: Additional keyword arguments passed to subprocess.Popen.
+
+    Raises:
+        ToolNotFoundError: If resolve_executable is True and the tool cannot be found.
+
+    Returns:
+        Popen instance.
+    """
+    stdin = kwargs.get("stdin")
+    if stdin is not None and stdin is not subprocess.DEVNULL:
+        raise ValueError("popen_resolved_detached only supports stdin=DEVNULL.")
+    kwargs["stdin"] = subprocess.DEVNULL
+
+    if os.name == "nt":
+        # Windows-specific process creation flags for detaching
+        create_new_process_group = getattr(subprocess, "CREATE_NEW_PROCESS_GROUP", 0)
+        create_no_window = getattr(subprocess, "CREATE_NO_WINDOW", 0)
+        flags = create_new_process_group | create_no_window
+        kwargs["creationflags"] = kwargs.get("creationflags", 0) | flags
+    else:
+        # POSIX way of detaching
+        kwargs["start_new_session"] = True
+
+    return popen_resolved(args, resolve_executable=resolve_executable, **kwargs)
diff --git a/src/google/agents/cli/dev/cmd_playground.py b/src/google/agents/cli/dev/cmd_playground.py
@@ -14,6 +14,7 @@
 
 """agents-cli playground command — start local agent playground."""
 
+import os
 import shlex
 
 import click
@@ -66,9 +67,13 @@ def cmd_playground(port, host, reload_agents, trace_to_cloud):
         host,
         "--port",
         str(port),
-        "--allow_origins",
-        "*",
     ]
+
+    # A '*' value is improperly shell-expanded on Windows due to an ADK bug,
+    # see b/525208532. Work around it by only passing the flag for non-Windows.
+    if os.name != "nt":
+        args.extend(["--allow_origins", "*"])
+
     if reload_agents:
         args.append("--reload_agents")
     if trace_to_cloud:
diff --git a/src/google/agents/cli/run/_local_server.py b/src/google/agents/cli/run/_local_server.py
@@ -17,17 +17,18 @@
 from __future__ import annotations
 
 import json
+import logging
 import os
-import signal
 import socket
 import time
 from datetime import UTC, datetime
 from pathlib import Path
 from typing import NamedTuple
 
 import click
+import psutil
 
-from google.agents.cli._runner import popen_resolved
+from google.agents.cli._runner import popen_resolved_detached
 
 _PID_DIR = ".google-agents-cli"
 _PID_FILENAME = "run_server.json"
@@ -195,14 +196,12 @@ def _start_server(
 
     log_file = open(log_path, "a", encoding="utf-8")
     try:
-        proc = popen_resolved(
+        proc = popen_resolved_detached(
             cmd,
             cwd=str(project_root),
             stdout=log_file,
             stderr=log_file,
             env=env,
-            # Detach from the CLI process so the server survives after exit.
-            start_new_session=True,
         )
     finally:
         # Close the parent's copy of the fd — the child inherits its own.
@@ -321,19 +320,21 @@ def _cleanup(project_root: Path, info: dict) -> None:
     pid = info.get("pid")
     if pid:
         try:
-            os.kill(pid, signal.SIGTERM)
-        except OSError:
-            pass
-        else:
-            # Wait briefly for the process to release its port.
-            try:
-                os.waitpid(pid, os.WNOHANG)
-            except ChildProcessError:
-                # Not a direct child — fall back to a short sleep so the
-                # port is freed before we attempt to bind a new one.
-                time.sleep(0.3)
+            parent = psutil.Process(pid)
+            children = parent.children(recursive=True)
+            for child in children:
+                try:
+                    child.terminate()
+                except psutil.NoSuchProcess:
+                    pass
+            parent.terminate()
+            psutil.wait_procs([*children, parent], timeout=3)
+        except psutil.NoSuchProcess:
+            logging.warning(
+                "Local server process with PID %d not found, skipping termination.", pid
+            )
     path = _pid_file_path(project_root)
     try:
-        path.unlink()
-    except OSError:
-        pass
+        path.unlink(missing_ok=True)
+    except OSError as exc:
+        logging.warning("Failed to remove PID file %s: %s", path, exc)

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "google-agents-cli",`
`3`		`- "version": "0.5.0",`
	`3`	`+ "version": "0.5.1",`
`4`	`4`	`"description": "Scaffold, develop, evaluate, and deploy AI agents with Google ADK. Bundles 7 skills for the agent development lifecycle.",`
`5`	`5`	`"author": { "name": "Google LLC" },`
`6`	`6`	`"homepage": "https://github.com/google/agents-cli",`
Original file line number	Diff line number	Diff line change
@@ -9,4 +9,4 @@ We value your input — it helps us improve `agents-cli` for the community.
`9`	`9`
`10`	`10`	`## Contributing`
`11`	`11`
`12`		-The best way to contribute is through feedback: bug reports, feature requests, and ideas shared via [issues](https://github.com/google/agents-cli/issues) to directly shape our roadmap. The CLI is distributed as a pre-built wheel rather than as source in the repository, which lets us iterate quickly while keeping the public interface stable. The code is not obfuscated — you can inspect any release by extracting the `.whl` file (a standard zip archive).
	`12`	`+The best way to contribute is through feedback: bug reports, feature requests, and ideas shared via [issues](https://github.com/google/agents-cli/issues) to directly shape our roadmap.`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "google-agents-cli",`
`3`		`- "version": "0.5.0",`
	`3`	`+ "version": "0.5.1",`
`4`	`4`	`"description": "Scaffold, develop, evaluate, and deploy AI agents with Google ADK. Bundles 7 skills for the agent development lifecycle."`
`5`	`5`	`}`