Skip to navigation

Deepgram CLI 0.5.0: dg speak gets --out-file, dg init needs --yes outside a terminal

Deepgram CLI v0.5.0

Deepgram CLI v0.5.0, released 13 November, changes how dg speak saves audio, how dg init confirms setup outside a terminal, and what dg listen -o prints.

  • dg speak adds --out-file, which refuses to overwrite an existing file unless you also pass --force. -o/--output still works for the audio file but is deprecated and always overwrites.
  • Outside a terminal, including any AI-agent session, dg init needs --yes (the only way inside an AI-agent session) or --install (outside one) to run a template’s setup, and --start to start it; without one, it exits 1 with confirmation_required instead of running automatically.
  • dg listen -o json and -o yaml now print the server’s prerecorded response body as sent; -o table and -o csv are still no-ops. A new dg listen-only -o text prints the transcript alone. DEEPCTL_LISTEN_JSON=sdk restores the pre-0.5.0 SDK-parsed JSON shape. dg listen also adds --timeout for files and URLs, and saves a prerecorded result over 64 KiB to ~/.deepctl/results/ in an AI-agent session (--full-output prints it anyway).
  • dg login --api-key accepts a real key immediately, with no format check and no -f needed. A new confirmation_required guardrail asks for --yes instead when DEEPGRAM_API_KEY is already set in the environment. dg login --complete finishes an agent-assisted device login.
  • -o json errors on most pre-command failures now carry code, hint, next_step, and schema_version fields alongside the existing error/status; .message // .error still reads every shape safely.
  • An unexpanded ${...} placeholder in DEEPGRAM_API_KEY, DEEPGRAM_PROFILE, DEEPGRAM_PROJECT_ID, or DEEPGRAM_BASE_URL is now ignored with a warning, and a system keyring that doesn’t answer within 2 seconds is skipped in favor of the next credential source.
  • DEEPCTL_TELEMETRY=log and =off, plus DO_NOT_TRACK and CI, join DEEPCTL_TELEMETRY_DISABLED as telemetry opt-outs. By default, with no DEEPCTL_TELEMETRY_DSN set, dg has no telemetry destination at all and sends nothing; see Install the CLI for exactly what a configured destination receives.
  • dg profiles --list now shows each profile’s stored key by its last 4 characters.

For details, see Deepgram CLI, Troubleshooting, and the deepgram/cli v0.5.0 release.