chore: release main

.github/.release-please-manifest.json

@@ -1,10 +1,10 @@
 {
-  ".": "0.3.2",
-  "packages/deepctl-core": "0.2.18",
+  ".": "0.3.3",
+  "packages/deepctl-core": "0.2.19",
   "packages/deepctl-shared-utils": "0.1.13",
   "packages/deepctl-telemetry": "0.0.7",
   "packages/deepctl-cmd-api": "0.0.2",
-  "packages/deepctl-cmd-login": "0.1.19",
+  "packages/deepctl-cmd-login": "0.1.20",
   "packages/deepctl-cmd-projects": "0.2.0",
   "packages/deepctl-cmd-transcribe": "0.1.12",
   "packages/deepctl-cmd-usage": "0.2.1",
@@ -17,11 +17,11 @@
   "packages/deepctl-cmd-ffprobe": "0.0.3",
   "packages/deepctl-cmd-mcp": "0.1.15",
   "packages/deepctl-cmd-update": "0.2.7",
-  "packages/deepctl-cmd-plugin": "0.1.13",
-  "packages/deepctl-cmd-skills": "0.0.8",
+  "packages/deepctl-cmd-plugin": "0.1.14",
+  "packages/deepctl-cmd-skills": "0.0.9",
   "packages/deepctl-cmd-init": "0.0.4",
   "packages/deepctl-cmd-models": "0.1.1",
-  "packages/deepctl-cmd-speak": "0.0.4",
+  "packages/deepctl-cmd-speak": "0.0.5",
   "packages/deepctl-cmd-keys": "0.1.0",
   "packages/deepctl-cmd-read": "0.1.0",
   "packages/deepctl-cmd-listen": "0.0.14",

CHANGELOG.md

@@ -1,5 +1,41 @@
 # Changelog
 
+## [0.3.3](https://github.com/deepgram/cli/compare/v0.3.2...v0.3.3) (2026-10-09)
+
+
+### Features
+
+* **core:** fetch the skills bundle from an immutable pin ([ab567de](https://github.com/deepgram/cli/commit/ab567dee5053e468494858ac3bccf14f2b3ef037))
+* **core:** fetch the skills bundle from an immutable pin ([#123](https://github.com/deepgram/cli/issues/123)) ([ca5ca98](https://github.com/deepgram/cli/commit/ca5ca984c4c956e2aa5589a4e8ba347246075dba))
+* **skills:** install and remove only skill folders deepctl owns ([b3d629e](https://github.com/deepgram/cli/commit/b3d629e1d53a729e7ce20fbf6ecf1101648cd3a3))
+* **skills:** install and remove only skill folders deepctl owns ([#124](https://github.com/deepgram/cli/issues/124)) ([5e227eb](https://github.com/deepgram/cli/commit/5e227ebf421518290626f3d3c332c860c1438532))
+* **skills:** prove and remove deepctl 0.3.x skill files after the new folders land ([f65e0e2](https://github.com/deepgram/cli/commit/f65e0e22868b3d8f7ac4e81d9163045aca3383ec))
+* **skills:** remove the deepctl 0.3.x skill files deepctl can prove it wrote ([#130](https://github.com/deepgram/cli/issues/130)) ([8be5172](https://github.com/deepgram/cli/commit/8be5172fc8d101dbcb60f5b1fb7b36e5f4cfbcff))
+* **skills:** remove the deepctl section from GEMINI.md, instructions.md and agents.md ([b7311a3](https://github.com/deepgram/cli/commit/b7311a30e10d04d753cdb43747a5c9f0f6cde71e))
+* **speak:** add --play and --list-voices to the speak command ([#110](https://github.com/deepgram/cli/issues/110)) ([fde4ed3](https://github.com/deepgram/cli/commit/fde4ed38920c9bf3a22acdef361f0fc9d204e8a3))
+
+
+### Bug Fixes
+
+* **core:** harden bundle publish races and Windows names ([70db676](https://github.com/deepgram/cli/commit/70db67620d7fb7e2c5df92f4f56387cbf69e5202))
+* **core:** re-prove cache ownership around the swap ([60f9630](https://github.com/deepgram/cli/commit/60f96304f96f9b71a6f9324f57f80c2e90da67f0))
+* **skills:** hold a skills.json lock across each tool's whole install and remove ([aa07edf](https://github.com/deepgram/cli/commit/aa07edfa8ff20e19b74389441724d4fd900e1c25))
+* **skills:** install skills from login and plugin through the shared installer ([1d34a22](https://github.com/deepgram/cli/commit/1d34a22c6b6c6ee2d87b3ee83657e7c28998a8fd))
+* **skills:** keep a newer skills ref and a removed tool when a refresh overlaps ([#126](https://github.com/deepgram/cli/issues/126)) ([3c9d1cf](https://github.com/deepgram/cli/commit/3c9d1cf3121a649a67b74ca9992cafdb0f2159ac))
+* **skills:** login and plugin install skills through the shared installer ([#125](https://github.com/deepgram/cli/issues/125)) ([3675f7a](https://github.com/deepgram/cli/commit/3675f7a21a34f59a6d1ab5c1c463149fec66d0e3))
+* **skills:** place folders with an atomic no-replace rename ([e678b4f](https://github.com/deepgram/cli/commit/e678b4f7b9a89e0bfb05de32f3a29af816d29b7e))
+* **skills:** re-check records in dg skills update and the plugin refresh ([b0b1595](https://github.com/deepgram/cli/commit/b0b15959214085e818a551f1c37cfb1645001c6a))
+* **skills:** retain legacy copies and skip Windows cleanup ([0f103af](https://github.com/deepgram/cli/commit/0f103afc97432924e269dfcf7febc11e9abe9922))
+* **skills:** skip a refreshed tool whose record changed while it downloaded ([1f86cd0](https://github.com/deepgram/cli/commit/1f86cd0a6bd08f67806797a57a8d631ef91ce9af))
+* **speak:** honor Aura's WAV default for playback ([3cf2d20](https://github.com/deepgram/cli/commit/3cf2d208e5d39ab8bf0dc28b596e9caababacf50))
+* **speak:** retain Aura's production MP3 default ([07d1e2b](https://github.com/deepgram/cli/commit/07d1e2bf8109092c403bcab06ac8887c6fcf77c7))
+
+
+### Documentation
+
+* **readme:** explain where skills go, the ownership rule and the requirements ([d1cf0f0](https://github.com/deepgram/cli/commit/d1cf0f0a36b8d9798491794321b9d1d579f88089))
+* **skills:** explain the 0.3.x upgrade cleanup ([21383d6](https://github.com/deepgram/cli/commit/21383d6f3fdf777e8c9b7b9da792f55c6f97b7f7))
+
 ## [0.3.2](https://github.com/deepgram/cli/compare/v0.3.1...v0.3.2) (2026-09-29)
 
 

packages/deepctl-cmd-login/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.1.20](https://github.com/deepgram/cli/compare/deepctl-cmd-login-v0.1.19...deepctl-cmd-login-v0.1.20) (2026-10-09)
+
+
+### Features
+
+* **skills:** prove and remove deepctl 0.3.x skill files after the new folders land ([f65e0e2](https://github.com/deepgram/cli/commit/f65e0e22868b3d8f7ac4e81d9163045aca3383ec))
+* **skills:** remove the deepctl 0.3.x skill files deepctl can prove it wrote ([#130](https://github.com/deepgram/cli/issues/130)) ([8be5172](https://github.com/deepgram/cli/commit/8be5172fc8d101dbcb60f5b1fb7b36e5f4cfbcff))
+
+
+### Bug Fixes
+
+* **skills:** install skills from login and plugin through the shared installer ([1d34a22](https://github.com/deepgram/cli/commit/1d34a22c6b6c6ee2d87b3ee83657e7c28998a8fd))
+* **skills:** login and plugin install skills through the shared installer ([#125](https://github.com/deepgram/cli/issues/125)) ([3675f7a](https://github.com/deepgram/cli/commit/3675f7a21a34f59a6d1ab5c1c463149fec66d0e3))
+
 ## [0.1.19](https://github.com/deepgram/cli/compare/deepctl-cmd-login-v0.1.18...deepctl-cmd-login-v0.1.19) (2026-09-29)
 
 

packages/deepctl-cmd-login/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepctl-cmd-login"
-version = "0.1.19" # x-release-please-version
+version = "0.1.20" # x-release-please-version
 description = "Login command for deepctl"
 readme = "README.md"
 license = "MIT"
@@ -21,7 +21,7 @@ classifiers = [
 keywords = ["deepgram", "cli", "login", "authentication"]
 requires-python = ">=3.10"
 dependencies = [
-    "deepctl-core>=0.1.10",
+    "deepctl-core>=0.2.19",
     "click>=8.0.0",
     "rich>=13.0.0",
     "deepgram-sdk>=7.7.0,<8",

packages/deepctl-cmd-plugin/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.1.14](https://github.com/deepgram/cli/compare/deepctl-cmd-plugin-v0.1.13...deepctl-cmd-plugin-v0.1.14) (2026-10-09)
+
+
+### Features
+
+* **skills:** prove and remove deepctl 0.3.x skill files after the new folders land ([f65e0e2](https://github.com/deepgram/cli/commit/f65e0e22868b3d8f7ac4e81d9163045aca3383ec))
+* **skills:** remove the deepctl 0.3.x skill files deepctl can prove it wrote ([#130](https://github.com/deepgram/cli/issues/130)) ([8be5172](https://github.com/deepgram/cli/commit/8be5172fc8d101dbcb60f5b1fb7b36e5f4cfbcff))
+
+
+### Bug Fixes
+
+* **skills:** install skills from login and plugin through the shared installer ([1d34a22](https://github.com/deepgram/cli/commit/1d34a22c6b6c6ee2d87b3ee83657e7c28998a8fd))
+* **skills:** keep a newer skills ref and a removed tool when a refresh overlaps ([#126](https://github.com/deepgram/cli/issues/126)) ([3c9d1cf](https://github.com/deepgram/cli/commit/3c9d1cf3121a649a67b74ca9992cafdb0f2159ac))
+* **skills:** login and plugin install skills through the shared installer ([#125](https://github.com/deepgram/cli/issues/125)) ([3675f7a](https://github.com/deepgram/cli/commit/3675f7a21a34f59a6d1ab5c1c463149fec66d0e3))
+* **skills:** re-check records in dg skills update and the plugin refresh ([b0b1595](https://github.com/deepgram/cli/commit/b0b15959214085e818a551f1c37cfb1645001c6a))
+
 ## [0.1.13](https://github.com/deepgram/cli/compare/deepctl-cmd-plugin-v0.1.12...deepctl-cmd-plugin-v0.1.13) (2026-09-23)
 
 

packages/deepctl-cmd-plugin/pyproject.toml

@@ -2,11 +2,11 @@
 name = "deepctl-cmd-plugin"
 description = "Plugin management command for deepctl"
 readme = "README.md"
-version = "0.1.13" # x-release-please-version
+version = "0.1.14" # x-release-please-version
 requires-python = ">=3.10"
 authors = [{ name = "Deepgram DevRel", email = "devrel@deepgram.com" }]
 dependencies = [
-    "deepctl-core>=0.1.10",
+    "deepctl-core>=0.2.19",
     "packaging>=21.0",
     "toml>=0.10.2",
 ]

packages/deepctl-cmd-skills/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [0.0.9](https://github.com/deepgram/cli/compare/deepctl-cmd-skills-v0.0.8...deepctl-cmd-skills-v0.0.9) (2026-10-09)
+
+
+### Features
+
+* **skills:** install and remove only skill folders deepctl owns ([b3d629e](https://github.com/deepgram/cli/commit/b3d629e1d53a729e7ce20fbf6ecf1101648cd3a3))
+* **skills:** install and remove only skill folders deepctl owns ([#124](https://github.com/deepgram/cli/issues/124)) ([5e227eb](https://github.com/deepgram/cli/commit/5e227ebf421518290626f3d3c332c860c1438532))
+* **skills:** prove and remove deepctl 0.3.x skill files after the new folders land ([f65e0e2](https://github.com/deepgram/cli/commit/f65e0e22868b3d8f7ac4e81d9163045aca3383ec))
+* **skills:** remove the deepctl 0.3.x skill files deepctl can prove it wrote ([#130](https://github.com/deepgram/cli/issues/130)) ([8be5172](https://github.com/deepgram/cli/commit/8be5172fc8d101dbcb60f5b1fb7b36e5f4cfbcff))
+* **skills:** remove the deepctl section from GEMINI.md, instructions.md and agents.md ([b7311a3](https://github.com/deepgram/cli/commit/b7311a30e10d04d753cdb43747a5c9f0f6cde71e))
+
+
+### Bug Fixes
+
+* **skills:** hold a skills.json lock across each tool's whole install and remove ([aa07edf](https://github.com/deepgram/cli/commit/aa07edfa8ff20e19b74389441724d4fd900e1c25))
+* **skills:** install skills from login and plugin through the shared installer ([1d34a22](https://github.com/deepgram/cli/commit/1d34a22c6b6c6ee2d87b3ee83657e7c28998a8fd))
+* **skills:** keep a newer skills ref and a removed tool when a refresh overlaps ([#126](https://github.com/deepgram/cli/issues/126)) ([3c9d1cf](https://github.com/deepgram/cli/commit/3c9d1cf3121a649a67b74ca9992cafdb0f2159ac))
+* **skills:** login and plugin install skills through the shared installer ([#125](https://github.com/deepgram/cli/issues/125)) ([3675f7a](https://github.com/deepgram/cli/commit/3675f7a21a34f59a6d1ab5c1c463149fec66d0e3))
+* **skills:** re-check records in dg skills update and the plugin refresh ([b0b1595](https://github.com/deepgram/cli/commit/b0b15959214085e818a551f1c37cfb1645001c6a))
+* **skills:** retain legacy copies and skip Windows cleanup ([0f103af](https://github.com/deepgram/cli/commit/0f103afc97432924e269dfcf7febc11e9abe9922))
+
 ## [0.0.8](https://github.com/deepgram/cli/compare/deepctl-cmd-skills-v0.0.7...deepctl-cmd-skills-v0.0.8) (2026-09-23)
 
 

packages/deepctl-cmd-skills/pyproject.toml

@@ -2,11 +2,11 @@
 name = "deepctl-cmd-skills"
 description = "AI coding assistant skill management for deepctl"
 readme = "README.md"
-version = "0.0.8" # x-release-please-version
+version = "0.0.9" # x-release-please-version
 requires-python = ">=3.10"
 authors = [{ name = "Deepgram DevRel", email = "devrel@deepgram.com" }]
 dependencies = [
-    "deepctl-core>=0.1.10",
+    "deepctl-core>=0.2.19",
     "click>=8.0.0",
     "rich>=13.0.0",
 ]

packages/deepctl-cmd-speak/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [0.0.5](https://github.com/deepgram/cli/compare/deepctl-cmd-speak-v0.0.4...deepctl-cmd-speak-v0.0.5) (2026-10-09)
+
+
+### Features
+
+* **speak:** add --play and --list-voices to the speak command ([59683a7](https://github.com/deepgram/cli/commit/59683a73db4ffe893fcf6f7f76c387b0136d7bbd))
+* **speak:** add --play and --list-voices to the speak command ([#110](https://github.com/deepgram/cli/issues/110)) ([fde4ed3](https://github.com/deepgram/cli/commit/fde4ed38920c9bf3a22acdef361f0fc9d204e8a3))
+
+
+### Bug Fixes
+
+* **speak:** carry voice languages as data and flag the unlisted default ([d8dffc4](https://github.com/deepgram/cli/commit/d8dffc44d8100aab682e3aed5e85980ef988d7a8))
+* **speak:** gate --play per player instead of treating paplay like aplay ([2dfdae2](https://github.com/deepgram/cli/commit/2dfdae25664ec7202c78d3b6b5e42492b5291a6c))
+* **speak:** honor Aura's WAV default for playback ([3cf2d20](https://github.com/deepgram/cli/commit/3cf2d208e5d39ab8bf0dc28b596e9caababacf50))
+* **speak:** keep --play honest about the file it saved and the empty pipe ([dafb3a9](https://github.com/deepgram/cli/commit/dafb3a9aebee710535f019c2065c10a073ef4479))
+* **speak:** list voices by their canonical -m value and languages ([a8cd658](https://github.com/deepgram/cli/commit/a8cd658a1e09ee0b0f84c3d40ff3148e75598205))
+* **speak:** print the errors the framework never shows, and re-order the pipe note ([9d9a3d0](https://github.com/deepgram/cli/commit/9d9a3d0a9a0120c9bbf8bbb01686ddcefdc6119e))
+* **speak:** retain Aura's production MP3 default ([07d1e2b](https://github.com/deepgram/cli/commit/07d1e2bf8109092c403bcab06ac8887c6fcf77c7))
+* **speak:** stop rich from eating bracketed paths out of error messages ([9bed27f](https://github.com/deepgram/cli/commit/9bed27fee88f5a2fc04015b80449ef68880c3deb))
+
 ## [0.0.4](https://github.com/deepgram/cli/compare/deepctl-cmd-speak-v0.0.3...deepctl-cmd-speak-v0.0.4) (2026-08-17)
 
 

packages/deepctl-cmd-speak/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepctl-cmd-speak"
-version = "0.0.4" # x-release-please-version
+version = "0.0.5" # x-release-please-version
 description = "Speak (text-to-speech) command for deepctl"
 readme = "README.md"
 license = "MIT"

packages/deepctl-core/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## [0.2.19](https://github.com/deepgram/cli/compare/deepctl-core-v0.2.18...deepctl-core-v0.2.19) (2026-10-09)
+
+
+### Features
+
+* **core:** fetch the skills bundle from an immutable pin ([ab567de](https://github.com/deepgram/cli/commit/ab567dee5053e468494858ac3bccf14f2b3ef037))
+* **core:** fetch the skills bundle from an immutable pin ([#123](https://github.com/deepgram/cli/issues/123)) ([ca5ca98](https://github.com/deepgram/cli/commit/ca5ca984c4c956e2aa5589a4e8ba347246075dba))
+* **skills:** install and remove only skill folders deepctl owns ([b3d629e](https://github.com/deepgram/cli/commit/b3d629e1d53a729e7ce20fbf6ecf1101648cd3a3))
+* **skills:** install and remove only skill folders deepctl owns ([#124](https://github.com/deepgram/cli/issues/124)) ([5e227eb](https://github.com/deepgram/cli/commit/5e227ebf421518290626f3d3c332c860c1438532))
+* **skills:** prove and remove deepctl 0.3.x skill files after the new folders land ([f65e0e2](https://github.com/deepgram/cli/commit/f65e0e22868b3d8f7ac4e81d9163045aca3383ec))
+* **skills:** remove the deepctl 0.3.x skill files deepctl can prove it wrote ([#130](https://github.com/deepgram/cli/issues/130)) ([8be5172](https://github.com/deepgram/cli/commit/8be5172fc8d101dbcb60f5b1fb7b36e5f4cfbcff))
+* **skills:** remove the deepctl section from GEMINI.md, instructions.md and agents.md ([b7311a3](https://github.com/deepgram/cli/commit/b7311a30e10d04d753cdb43747a5c9f0f6cde71e))
+* **speak:** add --play and --list-voices to the speak command ([#110](https://github.com/deepgram/cli/issues/110)) ([fde4ed3](https://github.com/deepgram/cli/commit/fde4ed38920c9bf3a22acdef361f0fc9d204e8a3))
+
+
+### Bug Fixes
+
+* **core:** harden bundle publish races and Windows names ([70db676](https://github.com/deepgram/cli/commit/70db67620d7fb7e2c5df92f4f56387cbf69e5202))
+* **core:** re-prove cache ownership around the swap ([60f9630](https://github.com/deepgram/cli/commit/60f96304f96f9b71a6f9324f57f80c2e90da67f0))
+* **skills:** hold a skills.json lock across each tool's whole install and remove ([aa07edf](https://github.com/deepgram/cli/commit/aa07edfa8ff20e19b74389441724d4fd900e1c25))
+* **skills:** install skills from login and plugin through the shared installer ([1d34a22](https://github.com/deepgram/cli/commit/1d34a22c6b6c6ee2d87b3ee83657e7c28998a8fd))
+* **skills:** keep a newer skills ref and a removed tool when a refresh overlaps ([#126](https://github.com/deepgram/cli/issues/126)) ([3c9d1cf](https://github.com/deepgram/cli/commit/3c9d1cf3121a649a67b74ca9992cafdb0f2159ac))
+* **skills:** login and plugin install skills through the shared installer ([#125](https://github.com/deepgram/cli/issues/125)) ([3675f7a](https://github.com/deepgram/cli/commit/3675f7a21a34f59a6d1ab5c1c463149fec66d0e3))
+* **skills:** place folders with an atomic no-replace rename ([e678b4f](https://github.com/deepgram/cli/commit/e678b4f7b9a89e0bfb05de32f3a29af816d29b7e))
+* **skills:** retain legacy copies and skip Windows cleanup ([0f103af](https://github.com/deepgram/cli/commit/0f103afc97432924e269dfcf7febc11e9abe9922))
+* **skills:** skip a refreshed tool whose record changed while it downloaded ([1f86cd0](https://github.com/deepgram/cli/commit/1f86cd0a6bd08f67806797a57a8d631ef91ce9af))
+
 ## [0.2.18](https://github.com/deepgram/cli/compare/deepctl-core-v0.2.17...deepctl-core-v0.2.18) (2026-09-29)
 
 

packages/deepctl-core/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepctl-core"
-version = "0.2.18" # x-release-please-version
+version = "0.2.19" # x-release-please-version
 description = "Core components for deepctl"
 readme = "README.md"
 license = "MIT"

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepctl"
-version = "0.3.2" # x-release-please-version
+version = "0.3.3" # x-release-please-version
 description = "Official Deepgram CLI for speech recognition and audio intelligence"
 readme = "README.md"
 license = "MIT"
@@ -35,8 +35,8 @@ requires-python = ">=3.10"
 dependencies = [
     "click>=8.0.0",
     "deepgram-sdk>=7.7.0,<8",
-    "deepctl-core>=0.2.18",
-    "deepctl-cmd-login>=0.1.19",
+    "deepctl-core>=0.2.19",
+    "deepctl-cmd-login>=0.1.20",
     "deepctl-cmd-projects>=0.2.0",
     "deepctl-cmd-transcribe>=0.1.12",
     "deepctl-cmd-usage>=0.2.1",
@@ -50,11 +50,11 @@ dependencies = [
     "deepctl-cmd-debug-toolkit>=0.1.0",
     "deepctl-cmd-ffprobe>=0.0.3",
     "deepctl-cmd-update>=0.2.7",
-    "deepctl-cmd-plugin>=0.1.13",
-    "deepctl-cmd-skills>=0.0.8",
+    "deepctl-cmd-plugin>=0.1.14",
+    "deepctl-cmd-skills>=0.0.9",
     "deepctl-cmd-init>=0.0.4",
     "deepctl-cmd-models>=0.1.1",
-    "deepctl-cmd-speak>=0.0.4",
+    "deepctl-cmd-speak>=0.0.5",
     "deepctl-cmd-keys>=0.1.0",
     "deepctl-cmd-read>=0.1.0",
     "deepctl-cmd-listen>=0.0.14",

src/deepctl/__init__.py

@@ -1,7 +1,7 @@
 """deepctl - Official command-line interface for Deepgram's speech
 recognition API."""
 
-__version__ = "0.3.2"  # x-release-please-version
+__version__ = "0.3.3"  # x-release-please-version
 __author__ = "Deepgram"
 __email__ = "devrel@deepgram.com"
 __license__ = "MIT"