CHANGELOG.md

Changelog

0.2.18 (2026-04-04)

Features

• auth: implement JWT-based device flow with silent token refresh (0817978)

Bug Fixes

• deps: resolve deepgram-mcp from PyPI instead of local path (dfe0030)

0.2.17 (2026-03-31)

Bug Fixes

• debug: correct debug audio example to use --file/-f flag (42dcdad)
• listen: emit metadata as WebVTT NOTE block in header, suppress status lines during caption streams (58808e2)
• listen: show captions before JSON output path so --webvtt and --srt work on pre-recorded files (16b4445)
• listen: suppress JSON summary after live caption streams (--mic/stdin --webvtt/--srt) (27c29e7)

0.2.16 (2026-03-31)

Features

• skills: fetch only repo skills, install as individual slash commands (243ca0f)
• web: add all-commands showcase section to landing page (2e8c843)

Bug Fixes

• ci: deploy staging on every push to main, not just web changes (399ceba)

0.2.15 (2026-03-31)

Features

• update: add hidden --record-install-method flag for install scripts (07f5035)

Bug Fixes

• release: ensure root package is always marked as latest (869f413)
• update: fix uv tool install detection when Python exe is a symlink (6b8dd9c)

0.2.14 (2026-03-31)

Bug Fixes

• listen: make sounddevice a hard dep and surface mic errors (6b3b088)
• update: serialize InstallMethod enum to string in all UpdateResult calls (dddba28)

0.2.13 (2026-03-30)

Bug Fixes

• listen: fix topics parameter name and add sentiment display (8974b6c)

0.2.12 (2026-03-30)

Bug Fixes

• update: serialize InstallMethod enum to string and fix command name (8213065)

0.2.11 (2026-03-30)

Bug Fixes

• listen: fix three root causes of missing transcript output (274aa41)

0.2.10 (2026-03-30)

Features

• test: add tests for check_prereqs tool detection in init lifecycle (73eac9b)

0.2.9 (2026-03-30)

Bug Fixes

• update: correct command name to 'dg update' in update notification (0a1b6af)
• update: use timezone-aware datetimes to fix offset comparison error (eb9d1d3)

0.2.8 (2026-03-30)

Features

• init: prereq checking, search-and-select picker, make init integration (7de0189)

Bug Fixes

• listen: handle Pydantic model_dump() None values in transcript extraction (39229b0)

0.2.7 (2026-03-29)

Features

• web: read CLI version from pyproject.toml at build time (097d1c0)

0.2.6 (2026-03-29)

Features

• web: add favicon from dx-design lettermark-square (7aa290c)

Bug Fixes

• ci: trigger web production deploy via workflow_call not release event (5913670)
• install: expose dg/deepgram aliases and fix PATH after install (bacc780)
• listen: use markup=False when printing transcript and summary (e87f68e)
• replace dg transcribe with dg listen across web content and skill generator (4676d34)

Documentation

• add examples section to README with captions, piping, and management (f7fd975)

0.2.5 (2026-03-29)

Features

• cli: add whoami, --dry-run, and shell completion (5577ef2)
• core: add AI agent detection and --agent-friendly flag (a5de7e2)
• listen: auto-select listen.v2 for flux-* models (9920023)
• listen: unified STT command with captions and transcribe alias (1c6e8d8)
• web: add Astro landing page for deepgram CLI (91079df)
• web: comprehensive SEO, OG, JSON-LD, GEO, and LLM optimisation (346625f)
• web: randomised terminal demo with caption examples (7ee635c)
• web: switch install to deepgram.com/install.sh and install.ps1 (d5e07ae)
• web: use Deepgram wordmark, simplify nav and hero install CTA (42cd42f)

Bug Fixes

• ci: fix netlify deploy — add --no-build, remove silent error swallowing (be2ff3f)
• web: accurate terminal demo — correct model names and 14 sequences (3b2a861)
• web: generate og-image.png at build time via @resvg/resvg-js (1897c0b)

0.2.4 (2026-03-25)

Features

• skills: fetch latest skills from deepgram/skills on every install (b498311)
• skills: interactive tool selection for skills setup (382b7a0)

Bug Fixes

• mcp: update default base URL to api.dx.deepgram.com (c514545)

0.2.3 (2026-03-24)

Documentation

• add community files from SDK template (7deb2ba)
• add MIT license file (9334818)
• point Code of Conduct to canonical community URL (b1ae7f5)
• replace generic CoC with official Deepgram Code of Conduct (187eb1b)
• rewrite README with banner image, add logo to CLI help (8c51166)

0.2.2 (2026-03-23)

Features

• add 8 new commands covering full Deepgram API surface (a034321)
• install: add Windows installer and version/force options (59620b2)

0.2.1 (2026-03-09)

Features

• install: replace Homebrew with curl-pipe-sh installer (87bd0c6)

0.2.0 (2026-03-09)

⚠ BREAKING CHANGES

• core: InstallationDetector and VersionChecker moved from deepctl_core to deepctl_cmd_update

Features

• Add API key verification system (0796b1e)
• Add Homebrew testing infrastructure (27e1171)
• add MCP server command for Gnosis AI integration (4babddf)
• add models module with FileInfo model (a0cb5aa)
• add performance timing system with --timing and --timing-detailed flags (45132ff)
• Add plugin search command with hardcoded registry (bd533cb)
• Add self-update functionality to deepctl (b2152f2)
• Add universal plugin support for all installation methods (6c6d3c3)
• api,debug: add deepctl api command, debug stream proxy, and debug improvements (53accd5)
• auth: switch device flow from community server to dx-id OIDC provider (2c04fc2)
• browser-debug: add browser debug HTML interface (e44a070)
• browser-debug: add dependencies and test configuration (6b74cd9)
• browser-debug: implement browser capability models (c2e3cbc)
• browser-debug: implement WebSocket-based browser debug command (d4902f8)
• complete nested command architecture implementation (f3a9945)
• core: comprehensive architecture review and test coverage (25a5409)
• debug-audio: add ffmpeg-python dependency for audio file analysis (398b2eb)
• debug-audio: implement comprehensive audio file analysis (fb773b6)
• docs: auto-generate root README sections from pyproject.toml (5c8cb9a)
• Enable PyPI publishing in release workflow (d78f2e2)
• enhance Makefile with better organization and documentation (944d195)
• enhance performance timing and core architecture (830aa47)
• enhance test infrastructure with flexible running options (d42a5e9)
• ffprobe: add audio analysis via ffprobe across CLI (8e2c923)
• Implement comprehensive network debug command (0d6c310)
• implement hybrid homebrew distribution strategy (548b65f)
• improve update command functionality (4a9baa0)
• init: add dg init command to scaffold Deepgram starter apps (60c17c3)
• initial commit (7365137)
• mcp: fix auth, switch to streamable-http, and improve READMEs (8e76d60)
• mcp: rearchitect as proxy to dx-api MCP endpoint (65a62f4)
• plugin: add install-aware plugin system with venv bridge and strategy pattern (7dd849b)
• setup uv workspace (monorepo) structure (42eec32)
• skills: add deepctl skills command and agent-native CLI metadata (5654d40)
• skills: replace CLI help dump with Deepgram Developer Guide (4182d9b)
• standardize release process with Makefile commands (79083d4)
• update authentication and core modules (1a1df1c)
• update authentication and security implementation (44d5568)
• update: add background plugin update notifications (5dfb906)
• update: overhaul update/upgrade system with expanded detection and startup notifications (f71437a)

Bug Fixes

• add --find-links to release workflow for local dependency resolution (b5f0a01)
• add contents read permissions to GitHub Actions jobs (759cd57)
• add explicit exports to core models (2827f9a)
• auth: decouple API key validation from project ID requirement (0f67b22)
• auth: open browser and start polling immediately on login (ecb8271)
• auto-detect CI environment in publish script to avoid EOFError (ebfe5d4)
• complete pyproject.toml package configuration (bf7d898)
• configure pytest to run tests across all workspace packages (17e1ba6)
• debug-audio: correct indentation in error handling blocks (f8931a2)
• debug-audio: restore correct indentation in handle method (e40cf29)
• handle graceful shutdown of MCP server to prevent threading errors (0fbb772)
• improve MCP server shutdown handling to work with single Ctrl+C (7bc1d94)
• make MCP server actually exit on first Ctrl+C (4b4a245)
• MCP server now exits cleanly on first Ctrl+C (49c4aca)
• package verification for deepctl-cmd-plugin (d00a792)
• Remove duplicate entries in plugin list (11a3fe3)
• resolve all ruff and mypy linting issues (83eaa7a)
• resolve mypy type checking issues and modernize Python code (a93526e)
• resolve regex SyntaxWarnings in version.py script (373911a)
• skills: fix entry point iteration in collect_command_metadata (7b8424f)
• skip confirmation prompt in non-interactive mode (2bf3ac5)
• tests: make config tests cross-platform compatible for Windows (701263d)
• tests: skip Unix-specific path tests on Windows (71ee600)
• tests: update integration tests for audio command required file argument (a12c5af)
• tests: use real tmp_path for pipx run detection test (7b0a8d6)
• tooling: resolve all ruff, mypy, and Makefile issues (3500379)
• transcribe: fix SDK response serialization and redesign output (908097c)
• Update test assertions to match actual command class names and Click behavior (c85d756)
• use absolute path for --find-links in pipx installation instructions (bc928ac)

Documentation

• add architecture documentation for MCP server and plugin system (b65af57)
• Add comprehensive Homebrew testing guide (0203e9e)
• add comprehensive project documentation (ed94015)
• add comprehensive testing and test strategy documentation (77dd5db)
• Add future plans for plugin registry URL-based system (067b658)
• Add plugin search command to main README (e1b2548)
• add release documentation to README (d73dc3d)
• add versioning strategy and PyPI publishing guides (b1e2e9c)
• browser-debug: add comprehensive architecture documentation (90a0873)
• debug-audio: add comprehensive documentation (6a32c2b)
• fix critical inconsistencies between documentation and code (6455932)
• improve local installation instructions in build script (ed04659)
• prioritize pipx for global installation with plugin support (0c17869)
• readme: document install-aware plugin system and strategies (3f0a8cf)
• readme: regenerate READMEs for new api and debug-stream packages (bd7170a)
• reorganize documentation structure (0e6f279)
• simplify and restructure README for better clarity (95aa5ec)
• update architecture and home documentation (56b4650)
• update documentation to reflect current architecture and improve clarity (bbf75b0)
• update plugin example README (1b825a6)