> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.deepgram.com/llms.txt.

# 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](/developer-tools/cli/installation) 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](/developer-tools/cli/getting-started), [Troubleshooting](/developer-tools/cli/troubleshooting), and the [deepgram/cli v0.5.0 release](https://github.com/deepgram/cli/releases/tag/v0.5.0).