Deepgram CLI Skills Guide

Tool

@deepgram/cli — command-line interface for Deepgram speech-to-text.

Install

npm install -g @deepgram/cli

Auth

deepgram login

Uses your Deepgram API key (stored locally).

Core Skill: Speech → Text

Transcribe a Local Audio File

deepgram listen prerecorded audio.wav

Transcribe with Options

deepgram listen prerecorded audio.wav \
  --model nova-2 \
  --language en \
  --punctuate \
  --diarize

Core Skill: Read / Reach Content

From URL (remote audio)

deepgram listen prerecorded https://example.com/audio.mp3

From STDIN (pipes)

cat audio.wav | deepgram listen prerecorded -

From Microphone (live)

deepgram listen microphone

Stop with Ctrl+C. Congrats, you just dictated reality.

Output Handling

Save Transcript

deepgram listen prerecorded audio.wav > transcript.json

Plain Text Output

deepgram listen prerecorded audio.wav --format text

Useful Flags (Memorize These)

• --model – nova-2, general, etc.

• --language – en, tr, de, …

• --punctuate – adds punctuation

• --diarize – speaker separation

• --format – json, text, srt, vtt

Typical Workflow

1. Reach content (file / URL / mic)

2. Run deepgram listen

3. Capture output (JSON or text)

4. Post-process (search, summarize, subtitle)

Skill Summary

• CLI-based speech-to-text

• Local, remote, and live audio

• Scriptable, pipe-friendly

• Fast, accurate, no UI nonsense

Deepgram CLI: because keyboards are overrated.