clerk · rafa-thayto · Aug 12, 2026 · Aug 12, 2026
diff --git a/.changeset/dry-spoons-bake.md b/.changeset/dry-spoons-bake.md
diff --git a/.changeset/silent-weeks-decide.md b/.changeset/silent-weeks-decide.md
diff --git a/.changeset/usage-telemetry.md b/.changeset/usage-telemetry.md
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
@@ -1,5 +1,11 @@
 # clerk
 
+## 3.1.0
+
+### Minor Changes
+
+- Collect usage telemetry (command name, flag names, duration, outcome, a random machine identifier — and your workspace and app IDs when a project is linked; never arguments, option values, paths, or personal data). The first run only shows a disclosure notice and sends nothing (CI environments send from the first run), and `--verbose` prints every event before it is sent. Control it with the new `clerk telemetry status|disable|enable` subcommand, or the `CLERK_TELEMETRY_DISABLED` / `DO_NOT_TRACK` environment variables (any non-false value opts out). ([#410](https://github.com/clerk/cli/pull/410)) by [@djgould](https://github.com/djgould)
+
 ## 3.0.1
 
 ### Patch Changes

diff --git a/packages/cli/package.json b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "clerk",
-  "version": "3.0.1",
+  "version": "3.1.0",
   "private": true,
   "description": "Clerk CLI",
   "keywords": [