From 646e52e2d29ba69c583df81b04e57ac2d0bc5ff0 Mon Sep 17 00:00:00 2001
From: "aspire-repo-bot[bot]"
 <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Date: Thu, 1 Oct 2026 19:27:41 +0000
Subject: [PATCH] docs: add CLI installation source telemetry data point

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 .../docs/reference/cli/microsoft-collected-cli-telemetry.mdx     | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/frontend/src/content/docs/reference/cli/microsoft-collected-cli-telemetry.mdx b/src/frontend/src/content/docs/reference/cli/microsoft-collected-cli-telemetry.mdx
index d1d6103f3..76b3e0981 100644
--- a/src/frontend/src/content/docs/reference/cli/microsoft-collected-cli-telemetry.mdx
+++ b/src/frontend/src/content/docs/reference/cli/microsoft-collected-cli-telemetry.mdx
@@ -58,6 +58,7 @@ Aspire CLI collects the following data:
 | 13.5 | Coding agent detection. | When the CLI is invoked from a known coding agent environment (such as GitHub Copilot, Claude, Cursor, or others), the detected agent name is recorded. Only the known agent name is sent — no environment variable values or other identifying data are included. This data point is omitted entirely when no known coding agent is detected. |
 | 13.6 | Coding agent detection: GitHub Copilot app. | The detector now separately identifies the GitHub Copilot app (the desktop GitHub application acting as an AI agent) as `copilot-app`, in addition to `copilot-cli` when the underlying Copilot CLI environment variables are also present. |
 | 13.5 | AI agent skill usage. | Recorded only for Aspire's own skills and tools. See [AI agent skill usage data](#ai-agent-skill-usage-data). |
+| 17.0 | CLI installation source. | Identifies how the running CLI was installed: `script` (the bash or PowerShell installer), `winget`, `npm`, `dotnet-tool`, `brew`, `mise`, `nix`, `pr`, `localhive`, or `unknown`. This is independent of the CLI's effective release channel and lets Microsoft understand usage by installation mechanism. No sidecar strings or installation paths are sent — only the matched, known source value. |
 
 ### AI agent skill usage data