Skip to content

Add LLM detection telemetry documentation for .NET CLI #48930

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 5 commits into
base: main
Choose a base branch
from
+16 −0
Draft

Add LLM detection telemetry documentation for .NET CLI #48930

Changes from 4 commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
d666375
Initial plan
Copilot Oct 6, 2025
78cc92b
Add LLM detection section to .NET CLI telemetry documentation
Copilot Oct 6, 2025
d44e51b
Update LLM detection section in telemetry documentation
meaghanlewis Oct 6, 2025
8da2d42
Add additional LLM agent detections from SDK PR #51054
Copilot Oct 7, 2025
6ddbe61
Apply suggestion from @baronfel
baronfel Oct 7, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions docs/core/tools/telemetry.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -106,6 +106,7 @@ The telemetry feature collects the following data:
| >=8.0.100 | Whether library mode for mobile is used. |
| >=8.0.100 | Whether NativeAOT is used. |
| >=8.0.100 | Used Mono runtime pack version. |
| >=10.0.100 | If the CLI was invoked from an LLM agent, the detected LLM agent name is reported. For more information, see [LLM Detection](#llm-detection).|

### Collected options

Expand Down Expand Up @@ -190,6 +191,22 @@ The full list of environment variables, and what is done with their values, is s
| TEAMCITY_VERSION | TeamCity | Check if present and non-null |
| JB_SPACE_API_URL | JetBrains Space | Check if present and non-null |

## LLM Detection

To detect if the .NET CLI is running in the context of an LLM agent, the .NET CLI probes for the presence and values of several environment variables that LLM agents and AI coding assistants set.

The following table shows the agent name, environment variables used for detection and the value of the agent type that is reported. The actual values of these environment variables are never collected—only used to identify the agent type.

| LLM agent | Variable(s) | Value |
| --------- | ----------- | ----- |
| GitHub Copilot | COPILOT_CLOUD_ENVIRONMENT | "copilot" |
| Claude Code | CLAUDECODE | "claude" |
| Cursor | CURSOR_SESSION_ID | "cursor" |
| Windsurf | CASCADE_SESSION_ID | "windsurf" |
| Cline | CLINE | "cline" |
| Roo Code | ROOCODE | "roo-code" |
| Zed | ZED_TERM | "zed" |

## Avoid inadvertent disclosure of information

.NET contributors and anyone else running a version of the .NET SDK that they built themselves should consider the path to their SDK source code. If a crash occurs while using a .NET SDK that is a custom debug build or configured with custom build symbol files, the SDK source file path from the build machine is collected as part of the stack trace and isn't hashed.
Expand Down