You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 2c39459
Browse filesBrowse the repository at this point in the historyBrowse files
from command dispatch to exit, so it excludes CLI startup), CLI/Python versions,
183
+
and OS — never file contents, arguments, or other input. Commands added by
184
+
extensions are recorded without their names.
185
+
186
+
The request that writes the entry also carries usage metadata in its
187
+
`User-Agent` and `X-Goog-Api-Client` headers, which Google receives for
188
+
agents-cli usage analytics: the CLI and Python versions, the OS and its release,
189
+
the CPU architecture, the command name and a random per-invocation ID. The log
190
+
entry's contents, such as the exit code, error class and duration, stay in your
191
+
project.
192
+
193
+
To opt out of sending telemetry, use one of the following environment variables:
194
+
195
+
```bash
196
+
# our cli-specific variable
197
+
# 0, false, no, or off (case-insensitive):
198
+
export AGENTS_CLI_TELEMETRY=0
199
+
200
+
# donottrack.sh standard variable
201
+
export DO_NOT_TRACK=1
202
+
```
203
+
204
+
Use `agents-cli info` to see the current telemetry state.
205
+
168
206
## Terms of Service
169
207
170
208
`agents-cli` leverages Google Cloud APIs. When you deploy agents, you'll be deploying resources in your own Google Cloud project and will be responsible for those resources. Please review the [Google Cloud Service Terms](https://cloud.google.com/terms/service-terms) for details.
Copy file name to clipboardExpand all lines: RELEASE_NOTES.md
+22Lines changed: 22 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,6 +3,26 @@
3
3
All notable changes to this project will be documented in this file.
4
4
5
5
6
+
## [1.8.0] - 2026-09-30
7
+
8
+
- New flag for`agents-cli scaffold upgrade`: `--force`. A fallback for when the 3-way merge cannot run or leaves too many conflicts, similar to the existing flag for `agents-cli scaffold enhance`. It generates only the new template and overwrites the scaffolding files:
9
+
- Agent code, config files and files you own are kept: your tests, custom eval metrics, eval datasets, READMEs, agent guidance files, `.gitignore`, `deployment_metadata.json` and Terraform `env.tfvars` files.
10
+
- Dependencies are merged as a union. For a dependency in both files the template's version wins, and dependencies only your project has are kept.
11
+
-`agents-cli scaffold upgrade` keeps your Terraform `env.tfvars` files instead of treating them as template files.
12
+
-`agents-cli scaffold upgrade` and `agents-cli scaffold enhance` stop with an error when writing the merged dependencies fails. Previously they reported success and stamped the new version, so a rerun said "already at version" and could not retry.
13
+
-`agents-cli run --mode a2a` sends messages and your bearer token only to the `--url` host, not to the endpoint declared in the agent card.
14
+
-https://github.com/google/agents-cli/issues/46
15
+
- Two concurrent `agents-cli deploy` deploys no longer overwrite each other's deployment state.
16
+
-https://github.com/google/agents-cli/issues/76
17
+
- Clarified the documentation on when to use `agents-cli infra single-project --apply` for deployments.
18
+
-https://github.com/google/agents-cli/issues/79
19
+
- Generated CI/CD Terraform for Cloud Build now waits for the CI/CD service account's IAM grants to propagate before creating build triggers, so the first push after `agents-cli infra cicd` no longer fails on missing permissions.
20
+
- Generated CI/CD Terraform grants Artifact Registry read access on the app's own repository instead of the whole CI/CD project. Destroying one project's infrastructure no longer breaks image pulls for other projects sharing the CI/CD project. A deploy project that relied on the project-wide grant to read another repository loses that access.
21
+
-`agents-cli deploy` prints pod state, pod descriptions and namespace events when a GKE rollout does not finish.
22
+
- Changed the formatting of some error messages so that they stand out more.
23
+
- Updated the ADK version in scaffolded projects to `google-adk>=2.9.2,<3.0.0`.
24
+
- Added experimental usage telemetry, off by default. Enable it with `AGENTS_CLI_EXPERIMENTS='{"cli_telemetry": true}'`. It writes one log entry per command to your own Cloud project, with the command, exit code, error class, duration, and CLI, Python and OS versions (but not arguments). Opt out with `AGENTS_CLI_TELEMETRY=0` or `DO_NOT_TRACK=1`.
25
+
6
26
## [1.7.0] - 2026-09-22
7
27
8
28
-**Live (voice) agents now work in `run` and `eval`.** Pass `--mode adk_live` wherever you already pass `--mode adk`:
@@ -18,6 +38,8 @@ All notable changes to this project will be documented in this file.
18
38
-`agents-cli deploy` and scaffolded Terraform both set `identity_type = SERVICE_ACCOUNT` on the Agent Runtime engine, so an agent keeps its service account when Agent Runtime changes that default to Agent Identity.
19
39
-`agents-cli scaffold create --agent <remote URL>` handles symlinks again. Since 1.4.1 every symlink in a remote template was dropped, so a template that shared a library across variants scaffolded a project that failed at import. Links inside the cloned repo are copied as real file contents, and a link pointing outside it stops the scaffold with an error.
20
40
-https://github.com/google/agents-cli/issues/89
41
+
-`agents-cli deploy` gets a new flag `--framework`, which sets the `agent_framework` property on the deployed agents.
42
+
-https://github.com/google/agents-cli/issues/63
21
43
- The generated Cloud SQL password no longer lands in Terraform state. State lives in `gs://{cicd_project}-terraform-state`, whose default IAM let anyone with Viewer on the CI/CD project read the prod database password. Generated Terraform now needs Terraform 1.11.0 or later.
22
44
- Scaffolded projects need `google-adk>=2.8.0`. 2.7.x does not emit `interactionStatus`, so a Live turn boundary falls back to a heuristic there. The `<2.9.0` cap from 1.6.1 is unchanged.
23
45
- The deprecated `--trace-to-cloud` alias is gone from `agents-cli playground` and `agents-cli run`. Use `--otel-to-cloud`.
Run `agents-cli scaffold enhance --help` to see all available options.
56
56
57
57
!!! tip
58
-
To enable observability features (prompt-response logging, content logs), run `agents-cli infra single-project` after deploying. Terraform provisions the telemetry resources and updates your service to use them. See the [Observability Guide](observability/index.md) for details.
58
+
To enable observability features (prompt-response logging, content logs), run `agents-cli infra single-project --apply` before deploying. Terraform provisions the telemetry resources, and the subsequent deploy uses them. See the [Observability Guide](observability/index.md) for details.
Copy file name to clipboardExpand all lines: docs/src/guide/development.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -118,7 +118,7 @@ Once the eval scores are good enough, deploy to Google Cloud.
118
118
```
119
119
120
120
!!! tip
121
-
To enable observability features (prompt-response logging, content logs), run `agents-cli infra single-project` after deploying. See the [Observability Guide](observability/index.md) for details.
121
+
To enable observability features (prompt-response logging, content logs), run `agents-cli infra single-project --apply` before deploying. See the [Observability Guide](observability/index.md) for details.
122
122
123
123
For production pipelines with staging, approval gates, and CI/CD, see [Deployment](deployment.md) and [CI/CD & Production](cicd.md).
Copy file name to clipboardExpand all lines: docs/src/guide/quickstart-tutorial.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -139,7 +139,7 @@ To go further and inspect the actual prompts and responses your agent handles in
139
139
140
140
> *"Set up observability infrastructure for my agent"*
141
141
142
-
Your coding agent runs `infra single-project`, which provisions the service account, GCS bucket, and BigQuery dataset — and updates the deployed service to use them. See the [Observability Guide](observability/index.md) for verification steps and advanced options.
142
+
Your coding agent runs `infra single-project --apply`, which provisions the service account, GCS bucket, and BigQuery dataset — and updates the deployed service to use them. See the [Observability Guide](observability/index.md) for verification steps and advanced options.
0 commit comments