From 72f955e1771b03967af0d748163790e8cc555503 Mon Sep 17 00:00:00 2001 From: "aspire-repo-bot[bot]" <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Date: Fri, 13 Nov 2026 00:08:02 +0000 Subject: [PATCH 1/2] Document user-scope telemetry hooks for project-scope agent init --- .../content/docs/reference/cli/commands/aspire-agent-init.mdx | 2 ++ .../docs/reference/cli/microsoft-collected-cli-telemetry.mdx | 2 ++ 2 files changed, 4 insertions(+) diff --git a/src/frontend/src/content/docs/reference/cli/commands/aspire-agent-init.mdx b/src/frontend/src/content/docs/reference/cli/commands/aspire-agent-init.mdx index aee5daa4c9..a38ab2772a 100644 --- a/src/frontend/src/content/docs/reference/cli/commands/aspire-agent-init.mdx +++ b/src/frontend/src/content/docs/reference/cli/commands/aspire-agent-init.mdx @@ -79,6 +79,8 @@ The following options are available: Write agent settings and companion skill files at the project or user scope. Interactive setup prompts for a scope; non-interactive setup defaults to `project`. + Skills and MCP configuration follow the selected scope. The [telemetry hooks](/reference/cli/microsoft-collected-cli-telemetry/#ai-agent-skill-usage) are always written to user-level configuration (`~/.copilot/hooks` and `~/.claude/settings.json`), even with `--scope project`, so they apply in every repository where that client runs. Set `ASPIRE_CLI_TELEMETRY_OPTOUT=true` to opt out. + - **`--skills `** Comma-separated choices: `aspire`, `playwright-cli`, or `dotnet-inspect`. The `dotnet-inspect` skill requires a C# AppHost in the workspace. Use `all` for every applicable choice or `none` to skip them. Defaults to `aspire`, which applies all enabled skill sources. MCP setup is separate. 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 d1d6103f36..8413901960 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 @@ -15,6 +15,8 @@ Aspire CLI telemetry is collected when using the CLI to run commands. Telemetry When you run `aspire agent init`, Aspire installs Aspire's AI skills and a `PostToolUse` hook into each detected agent client's user-level configuration (for example, GitHub Copilot CLI and Claude Code). The hook lets Aspire understand which of its AI skills and tools are actually used so the team can invest in the most valuable ones. +The hook is always installed at user scope, even when you run `aspire agent init --scope project`. Because user-level configuration applies to every repository, the hook runs wherever that client runs, but the client launches `aspire` only for tool calls that match Aspire skills, MCP tools, or reference files. + After each agent tool use, the hook checks if an **Aspire** skill, Aspire MCP tool, or Aspire skill reference file was involved. If so, the hook inspects the event and forwards a low-cardinality usage event to the hidden `aspire agent telemetry` command. The command records the event through the same CLI telemetry pipeline. Tool uses that don't involve Aspire skills or tools are ignored. See [AI agent skill usage data](#ai-agent-skill-usage-data) for exactly what's recorded. ## How to opt-out From 79a3ce6f2af087a67e750f0c4ff3d2df576590ea Mon Sep 17 00:00:00 2001 From: Ella Hathaway <67609881+ellahathaway@users.noreply.github.com> Date: Fri, 13 Nov 2026 15:44:17 -0800 Subject: [PATCH 2/2] Update telemetry hook usage reporting details Clarified that the hook reports usage events only for Aspire's skills, MCP tools, or skill reference files. Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- .../docs/reference/cli/microsoft-collected-cli-telemetry.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 8413901960..24bda7f79e 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 @@ -15,7 +15,7 @@ Aspire CLI telemetry is collected when using the CLI to run commands. Telemetry When you run `aspire agent init`, Aspire installs Aspire's AI skills and a `PostToolUse` hook into each detected agent client's user-level configuration (for example, GitHub Copilot CLI and Claude Code). The hook lets Aspire understand which of its AI skills and tools are actually used so the team can invest in the most valuable ones. -The hook is always installed at user scope, even when you run `aspire agent init --scope project`. Because user-level configuration applies to every repository, the hook runs wherever that client runs, but the client launches `aspire` only for tool calls that match Aspire skills, MCP tools, or reference files. +The hook is always installed at user scope, even when you run `aspire agent init --scope project`. Because user-level configuration applies to every repository, the hook runs wherever that client runs, but it reports usage events only for Aspire's own skills, MCP tools, or skill reference files. After each agent tool use, the hook checks if an **Aspire** skill, Aspire MCP tool, or Aspire skill reference file was involved. If so, the hook inspects the event and forwards a low-cardinality usage event to the hidden `aspire agent telemetry` command. The command records the event through the same CLI telemetry pipeline. Tool uses that don't involve Aspire skills or tools are ignored. See [AI agent skill usage data](#ai-agent-skill-usage-data) for exactly what's recorded.