Repository navigation
Release v1.9.0
- Usage telemetry is now on by default. Each command writes one log entry to your own Google Cloud project with the command name, exit code, error class, duration, and CLI, Python and OS versions, never arguments or file contents. Its purpose is to provide users with analytics regarding their tool use, process efficiency, and help diagnose potential issues. The request also sends Google the CLI, Python and OS versions, CPU architecture and command name for usage analytics; no sensitive data is sent. Opt out with
AGENTS_CLI_TELEMETRY=0orDO_NOT_TRACK=1.agents-cli infonow always shows whether telemetry is on. agents-cli deploy --keyencrypts an Agent Runtime agent with a customer-managed Cloud KMS key (CMEK), so deploys work in projects that enforceconstraints/gcp.restrictNonCmekServices. The key can only be set when the agent is created, anddeploy --listshows it in a new Encryption column.agents-cli deploy --dry-runchecks an Agent Runtime deployment against Google Cloud: enabled APIs, the target engine, IAM permissions,actAson the service account, and secrets. A definite problem exits with code 1, and a check that cannot run only warns. A dry run now makes read-only network calls. A real deploy is unchanged.agents-cli deployreports unsupported flags in one format,<flag> is only supported for <targets> deployments (current target: <target>), and names only the flags you passed. An empty value for such a flag, such as--key ""on Cloud Run, is now rejected instead of ignored. Scripts that match the old error text may need updating.- New ADK Python projects set
GOOGLE_GENAI_USE_ENTERPRISE=trueinstead of the deprecatedGOOGLE_GENAI_USE_VERTEXAI. Existing projects keep working:agents-cli deployto Agent Runtime respects whichever name your.envsets. Go projects keep the old name. - New ADK Go projects enable the
gofmtandgoimportsformatters, soagents-cli lintreports formatting issues andlint --fixfixes them. - Re-applying the Terraform generated by this release, for example with
agents-cli infra single-projectorinfra cicd, no longer replaces the BigQuery log sink tables once logs have arrived. The replacement deleted every exported log.completions_viewalso gains aservice_versioncolumn with the deployment revision. Runagents-cli scaffold upgradeto get this in an existing project. - Scaffolded ADK projects no longer append a duplicate
JSONRPC 0.3interface to the agent card on every request to.well-known/agent-card.json. - A tool that exists but cannot run, such as
uv.exeblocked by AppLocker on Windows, now fails with a clear error naming the tool and the OS reason instead of aPermissionErrortraceback. - Installed extensions no longer print a warning on every command. A notice appears only when a command overridden by an extension runs.