Merge pull request #1318 from jochenseeber/disable-usage-reporting-env-var

Allow disabling usage reporting via SERENA_USAGE_REPORTING env var

CHANGELOG.md

@@ -2,6 +2,9 @@
 
 Status of the `main` branch. Changes prior to the next official version change will appear here.
 
+* General:
+  - Support environment variable `SERENA_USAGE_REPORTING` (set to `false` to disable usage reporting)
+
 # 1.1.1
 
 * General:

docs/02-usage/050_configuration.md

@@ -863,3 +863,11 @@ prompts:
 ```
 
 It is advisable to use the default prompt as a starting point and modify it to suit your needs.
+
+### Usage Reporting
+
+On startup, Serena reports anonymous usage data to help us understand Serena usage.
+Specifically, we collect the Serena version, the operating system & language backend being used as well as the dashboard enabled status.
+No personally identifiable information or project-specific information is collected.
+
+If you want to opt out of usage reporting, set the environment variable `SERENA_USAGE_REPORTING` to `false`.

src/serena/agent.py

@@ -410,8 +410,7 @@ class SerenaAgent:
         self._send_usage_info()
 
     def _send_usage_info(self) -> None:
-        is_ci = os.getenv("CI") == "true" or os.getenv("GITHUB_ACTIONS") == "true"
-        if is_ci:
+        if os.getenv("CI") == "true" or os.getenv("GITHUB_ACTIONS") == "true" or os.getenv("SERENA_USAGE_REPORTING") == "false":
             return
         params: dict[str, str | int] = {
             "os": platform.system(),