diff --git a/AGENTS.md b/AGENTS.md
index 5224bffe..69b529b6 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -110,6 +110,7 @@ Lessons that cost time in agent sessions — read before exercising `uv run asse
 - Ruff lint set: see `[tool.ruff.lint]` in `pyproject.toml`. `S603/S607` are ignored project-wide because the CLI intentionally shells out to `claude`/`npx` with controlled args. `B008` is ignored (Typer uses `typer.Option/Argument` calls as defaults).
 - mypy is strict on `aai_cli` (`disallow_untyped_defs`); tests are type-checked but exempt from return annotations.
 - Errors → stderr, data → stdout. Preserve this split; it's what makes the CLI pipeline-safe.
+- **Help copy is terse and period-less (Codex-CLI style)**: one-line command summaries (the docstring's first line) and single-sentence option/argument `help=` strings are imperative, sentence-case, and carry **no trailing period** — `"Burn always-visible captions into a video"`, not `"…video."`. Only genuinely multi-sentence help (e.g. `"X. Default: Y."`) keeps normal punctuation. The strings render in `assembly --help`, so they're pinned by the syrupy `--help` goldens (`tests/__snapshots__/test_snapshots_help_*.ambr`) — regenerate with `--snapshot-update`, never hand-edit. Don't drop the period on internal helper docstrings (they aren't snapshot-covered, so the mutation gate would flag the changed line).
 - **Deprecate flags with hidden traps, not removal**: keep the old flag parsing (`hidden=True`), emit a one-line "use X instead" warning, and drop it a release or two later — never hard-break a script mid-cycle. `login --api-key` (→ `--with-api-key`) is the pattern to copy.
 - **Secrets never ride argv**: a key/token-valued option must read from stdin (`--with-api-key`) or the env, so it can't leak into shell history or `ps`. Run commands deliberately have no `--api-key` at all.
 - **Every NDJSON stream line carries a `"type"` field** (see REFERENCE.md "JSON output"); new event types are additive, existing fields stay stable.
diff --git a/aai_cli/commands/account.py b/aai_cli/commands/account.py
index 42028b82..92c9a3d4 100644
--- a/aai_cli/commands/account.py
+++ b/aai_cli/commands/account.py
@@ -125,7 +125,7 @@ class _Usage(BaseModel):
     usage_items: Annotated[list[_Window], _MappingList] = Field(default_factory=list[_Window])
 
 
-app = typer.Typer(help="Account billing, usage, and limits.")
+app = typer.Typer(help="Account billing, usage, and limits")
 
 SPEC = command_registry.CommandModuleSpec(
     panel=help_panels.ACCOUNT,
@@ -147,7 +147,7 @@ def balance(
     ctx: typer.Context,
     json_out: bool = options.json_option(),
 ) -> None:
-    """Show your remaining account balance."""
+    """Show your remaining account balance"""
 
     def body(state: AppState, json_mode: bool) -> None:
         _, jwt = state.resolve_session()
@@ -183,17 +183,17 @@ def usage(
     ),
     end: str | None = typer.Option(None, "--end", help="End date (YYYY-MM-DD). Default: today."),
     window: str | None = typer.Option(
-        None, "--window", help="Window size: 'day', 'week', or 'month'."
+        None, "--window", help="Window size: 'day', 'week', or 'month'"
     ),
     include_zero: bool = typer.Option(
         False,
         "--include-zero",
         "--all",
-        help="Include zero-usage windows (matches --include-logins on `assembly audit`).",
+        help="Include zero-usage windows (matches --include-logins on `assembly audit`)",
     ),
     json_out: bool = options.json_option(),
 ) -> None:
-    """Show usage over a date range (defaults to the last 30 days)."""
+    """Show usage over a date range (default: last 30 days)"""
 
     def body(state: AppState, json_mode: bool) -> None:
         # Parse/validate the flags before any session resolution or network work,
@@ -270,7 +270,7 @@ def limits(
     ctx: typer.Context,
     json_out: bool = options.json_option(),
 ) -> None:
-    """Show your account's rate limits per service."""
+    """Show your account's rate limits per service"""
 
     def body(state: AppState, json_mode: bool) -> None:
         account_id, jwt = state.resolve_session()
diff --git a/aai_cli/commands/agent/__init__.py b/aai_cli/commands/agent/__init__.py
index 6a92cffb..3112f57c 100644
--- a/aai_cli/commands/agent/__init__.py
+++ b/aai_cli/commands/agent/__init__.py
@@ -53,7 +53,7 @@ def agent(
         None, help="Audio file path or URL to speak to the agent. Omit to use the microphone."
     ),
     sample: bool = typer.Option(
-        False, "--sample", help="Speak the hosted wildfires.mp3 sample to the agent."
+        False, "--sample", help="Speak the hosted wildfires.mp3 sample to the agent"
     ),
     voice: str = typer.Option(
         DEFAULT_VOICE,
@@ -62,32 +62,32 @@ def agent(
         autocompletion=complete_voice,
     ),
     system_prompt: str = typer.Option(
-        DEFAULT_PROMPT, "--system-prompt", help="System prompt (the agent's persona)."
+        DEFAULT_PROMPT, "--system-prompt", help="System prompt (the agent's persona)"
     ),
     system_prompt_file: Path | None = typer.Option(
         None,
         "--system-prompt-file",
-        help="Read the system prompt from a file (overrides --system-prompt).",
+        help="Read the system prompt from a file (overrides --system-prompt)",
         exists=True,
         dir_okay=False,
     ),
-    greeting: str = typer.Option(DEFAULT_GREETING, "--greeting", help="Spoken greeting."),
-    device: int | None = typer.Option(None, "--device", help="Microphone device index."),
-    list_voices: bool = typer.Option(False, "--list-voices", help="Print known voices and exit."),
-    json_out: bool = options.json_option("Emit newline-delimited JSON events."),
+    greeting: str = typer.Option(DEFAULT_GREETING, "--greeting", help="Spoken greeting"),
+    device: int | None = typer.Option(None, "--device", help="Microphone device index"),
+    list_voices: bool = typer.Option(False, "--list-voices", help="Print known voices and exit"),
+    json_out: bool = options.json_option("Emit newline-delimited JSON events"),
     output_field: choices.TextOrJson | None = typer.Option(
         None,
         "-o",
         "--output",
-        help="Output mode: text (you:/agent: lines as plain stdout, pipe-friendly) or json.",
+        help="Output mode: text (you:/agent: lines as plain stdout, pipe-friendly) or json",
     ),
     show_code: bool = typer.Option(
         False,
         "--show-code",
-        help="Print the equivalent Python SDK code and exit (does not start a session).",
+        help="Print the equivalent Python SDK code and exit (does not start a session)",
     ),
 ) -> None:
-    """Have a live two-way voice conversation with an AssemblyAI voice agent.
+    """Hold a live two-way voice conversation with a voice agent
 
     Use headphones: the mic stays open while the agent speaks, so on
     speakers it would hear itself and loop. Pass an audio file/URL (or
diff --git a/aai_cli/commands/audit.py b/aai_cli/commands/audit.py
index 2981506d..454a3d57 100644
--- a/aai_cli/commands/audit.py
+++ b/aai_cli/commands/audit.py
@@ -10,7 +10,7 @@
 from aai_cli.context import AppState, run_command
 from aai_cli.help_text import examples_epilog
 
-app = typer.Typer(help="View your account's audit log.")
+app = typer.Typer(help="View your account's audit log")
 
 SPEC = command_registry.CommandModuleSpec(
     panel=help_panels.ACCOUNT,
@@ -93,15 +93,15 @@ def _audit_rows(payload: Mapping[str, object]) -> list[dict[str, object]]:
 )
 def audit(
     ctx: typer.Context,
-    limit: int = typer.Option(20, "--limit", min=1, help="How many entries to show."),
-    action: str | None = typer.Option(None, "--action", help="Filter by raw action name."),
-    resource: str | None = typer.Option(None, "--resource", help="Filter by raw resource type."),
+    limit: int = typer.Option(20, "--limit", min=1, help="How many entries to show"),
+    action: str | None = typer.Option(None, "--action", help="Filter by raw action name"),
+    resource: str | None = typer.Option(None, "--resource", help="Filter by raw resource type"),
     include_logins: bool = typer.Option(
-        False, "--include-logins", help="Show successful login events."
+        False, "--include-logins", help="Show successful login events"
     ),
     json_out: bool = options.json_option(),
 ) -> None:
-    """List recent audit-log entries for your account."""
+    """List recent audit-log entries for your account"""
 
     def body(state: AppState, json_mode: bool) -> None:
         _, jwt = state.resolve_session()
diff --git a/aai_cli/commands/caption/__init__.py b/aai_cli/commands/caption/__init__.py
index 581148fb..8c918ad2 100644
--- a/aai_cli/commands/caption/__init__.py
+++ b/aai_cli/commands/caption/__init__.py
@@ -44,32 +44,32 @@ def caption(
     media: str = typer.Argument(
         ...,
         help="Video to caption: a local file, or a YouTube/media-page URL "
-        "(the full video is downloaded via yt-dlp).",
+        "(the full video is downloaded via yt-dlp)",
     ),
     transcript_id: str | None = typer.Option(
         None,
         "--transcript-id",
         "-t",
-        help="Reuse an existing transcript of this media instead of transcribing it again.",
+        help="Reuse an existing transcript of this media instead of transcribing it again",
     ),
     chars_per_caption: int | None = typer.Option(
         None,
         "--chars-per-caption",
         min=1,
-        help="Max characters per caption line.",
+        help="Max characters per caption line",
     ),
     font_size: int | None = typer.Option(
         None,
         "--font-size",
         min=1,
-        help="Font size of the burned-in captions (ffmpeg's default styling when omitted).",
+        help="Font size of the burned-in captions (ffmpeg's default styling when omitted)",
     ),
     out: Path | None = typer.Option(
-        None, "--out", help="Output file (default: <name>.captioned<ext> next to the input)."
+        None, "--out", help="Output file (default: <name>.captioned<ext> next to the input)"
     ),
-    json_out: bool = options.json_option("Emit JSON describing the captioned file."),
+    json_out: bool = options.json_option("Emit JSON describing the captioned file"),
 ) -> None:
-    """Burn always-visible captions into a video.
+    """Burn always-visible captions into a video
 
     The video is transcribed (or an existing transcript is reused with
     --transcript-id), the transcript's SRT captions are fetched, and ffmpeg
diff --git a/aai_cli/commands/clip/__init__.py b/aai_cli/commands/clip/__init__.py
index 934c8613..064b4d9d 100644
--- a/aai_cli/commands/clip/__init__.py
+++ b/aai_cli/commands/clip/__init__.py
@@ -61,22 +61,22 @@ def clip(
     media: str = typer.Argument(
         ...,
         help="Audio/video to cut clips from: a local file, or a YouTube/media-page "
-        "URL (audio downloaded via yt-dlp).",
+        "URL (audio downloaded via yt-dlp)",
     ),
     transcript_id: str | None = typer.Option(
         None,
         "--transcript-id",
         "-t",
         help="Reuse an existing transcript of this media instead of transcribing it again: "
-        "an id, or '-' to read an id or 'transcribe --json' output from stdin.",
+        "an id, or '-' to read an id or 'transcribe --json' output from stdin",
     ),
     speaker: list[str] = typer.Option(
         [],
         "--speaker",
-        help="Keep segments spoken by this diarized speaker label (repeatable, e.g. --speaker A).",
+        help="Keep segments spoken by this diarized speaker label (repeatable, e.g. --speaker A)",
     ),
     search: str | None = typer.Option(
-        None, "--search", help="Keep segments whose text contains this (case-insensitive)."
+        None, "--search", help="Keep segments whose text contains this (case-insensitive)"
     ),
     llm_prompt: str | None = typer.Option(
         None,
@@ -88,32 +88,32 @@ def clip(
     model: str = typer.Option(
         llm.DEFAULT_MODEL,
         "--model",
-        help="LLM Gateway model for --llm.",
+        help="LLM Gateway model for --llm",
         rich_help_panel=help_panels.OPT_LLM,
         autocompletion=llm.complete_model,
     ),
     max_tokens: int = typer.Option(
         llm.DEFAULT_MAX_TOKENS,
         "--max-tokens",
-        help="Max tokens for the --llm selection reply.",
+        help="Max tokens for the --llm selection reply",
         rich_help_panel=help_panels.OPT_LLM,
     ),
     ranges: list[str] = typer.Option(
         [],
         "--range",
-        help="Keep an explicit START-END window (seconds or [HH:]MM:SS; repeatable).",
+        help="Keep an explicit START-END window (seconds or [HH:]MM:SS; repeatable)",
     ),
     padding: float = typer.Option(
-        0.0, "--padding", min=0.0, help="Seconds of padding to add around each clip."
+        0.0, "--padding", min=0.0, help="Seconds of padding to add around each clip"
     ),
     snap: bool = typer.Option(
         True,
         "--snap/--no-snap",
         help="Snap clip boundaries into nearby silence (detected with ffmpeg) so cuts "
-        "don't land mid-word; --no-snap cuts at the exact selected times.",
+        "don't land mid-word; --no-snap cuts at the exact selected times",
     ),
     out_dir: Path | None = typer.Option(
-        None, "--out-dir", help="Directory for the clip files (default: next to the input)."
+        None, "--out-dir", help="Directory for the clip files (default: next to the input)"
     ),
     video: bool = typer.Option(
         False,
@@ -121,9 +121,9 @@ def clip(
         help="Download the full video (not just the audio track) for a URL source, "
         "so the clips are cut from the video. Local files keep their video already.",
     ),
-    json_out: bool = options.json_option("Emit JSON describing the clips written."),
+    json_out: bool = options.json_option("Emit JSON describing the clips written"),
 ) -> None:
-    """Cut clips out of a media file by speaker, text match, LLM pick, or time range.
+    """Cut clips from media by speaker, text match, LLM pick, or time range
 
     --speaker and --search select from a diarized transcript (made on the fly,
     or reused with --transcript-id); --llm has an LLM Gateway model pick the
diff --git a/aai_cli/commands/config_cmd.py b/aai_cli/commands/config_cmd.py
index bb2765f7..5e220f93 100644
--- a/aai_cli/commands/config_cmd.py
+++ b/aai_cli/commands/config_cmd.py
@@ -26,7 +26,7 @@
 )
 
 app = typer.Typer(
-    help="Inspect and edit persisted CLI settings (profiles, env, telemetry).",
+    help="Inspect and edit persisted CLI settings (profiles, env, telemetry)",
     no_args_is_help=True,
 )
 
@@ -99,7 +99,7 @@ def path(
     ctx: typer.Context,
     json_out: bool = options.json_option(),
 ) -> None:
-    """Print where config.toml lives."""
+    """Print where config.toml lives"""
 
     def body(_state: AppState, json_mode: bool) -> None:
         file = config.config_file_path()
@@ -126,7 +126,7 @@ def list_settings(
     ctx: typer.Context,
     json_out: bool = options.json_option(),
 ) -> None:
-    """Show every persisted setting and the stored profiles."""
+    """Show every persisted setting and the stored profiles"""
 
     def body(_state: AppState, json_mode: bool) -> None:
         data: dict[str, object] = {
@@ -169,10 +169,10 @@ def render(d: dict[str, object]) -> object:
 )
 def get(
     ctx: typer.Context,
-    key: ConfigKey = typer.Argument(..., help="Which setting to read."),
+    key: ConfigKey = typer.Argument(..., help="Which setting to read"),
     json_out: bool = options.json_option(),
 ) -> None:
-    """Print one setting's stored value (`env` reads the selected profile's)."""
+    """Print one setting's stored value (`env` reads the selected profile's)"""
 
     def body(state: AppState, json_mode: bool) -> None:
         value = _current_value(key, state)
@@ -197,11 +197,11 @@ def body(state: AppState, json_mode: bool) -> None:
 )
 def set_setting(
     ctx: typer.Context,
-    key: ConfigKey = typer.Argument(..., help="Which setting to change."),
-    value: str = typer.Argument(..., help="The new value."),
+    key: ConfigKey = typer.Argument(..., help="Which setting to change"),
+    value: str = typer.Argument(..., help="The new value"),
     json_out: bool = options.json_option(),
 ) -> None:
-    """Change one setting (`env` writes to the selected profile)."""
+    """Change one setting (`env` writes to the selected profile)"""
 
     def body(state: AppState, json_mode: bool) -> None:
         stored = _store_value(key, value, state)
diff --git a/aai_cli/commands/deploy/__init__.py b/aai_cli/commands/deploy/__init__.py
index e8078d12..02a1ea4e 100644
--- a/aai_cli/commands/deploy/__init__.py
+++ b/aai_cli/commands/deploy/__init__.py
@@ -31,14 +31,14 @@
 )
 def deploy(
     ctx: typer.Context,
-    prod: bool = typer.Option(False, "--prod", help="Deploy to production (Vercel only)."),
-    vercel: bool = typer.Option(False, "--vercel", help="Deploy to Vercel (the default)."),
-    railway: bool = typer.Option(False, "--railway", help="Deploy to Railway."),
-    fly: bool = typer.Option(False, "--fly", help="Deploy to Fly.io."),
-    assume_yes: bool = typer.Option(False, "--yes", "-y", help="Skip the confirmation prompt."),
+    prod: bool = typer.Option(False, "--prod", help="Deploy to production (Vercel only)"),
+    vercel: bool = typer.Option(False, "--vercel", help="Deploy to Vercel (the default)"),
+    railway: bool = typer.Option(False, "--railway", help="Deploy to Railway"),
+    fly: bool = typer.Option(False, "--fly", help="Deploy to Fly.io"),
+    assume_yes: bool = typer.Option(False, "--yes", "-y", help="Skip the confirmation prompt"),
     json_out: bool = options.json_option(),
 ) -> None:
-    """Deploy the current project to Vercel (default), Railway, or Fly.io.
+    """Deploy the current project to Vercel, Railway, or Fly.io
 
     Asks for confirmation first, then runs the target's CLI (`vercel deploy`,
     `railway up`, or `fly launch`). Requires that target's CLI to be installed.
diff --git a/aai_cli/commands/dev/__init__.py b/aai_cli/commands/dev/__init__.py
index 6446d542..30ddae6c 100644
--- a/aai_cli/commands/dev/__init__.py
+++ b/aai_cli/commands/dev/__init__.py
@@ -33,19 +33,19 @@
 )
 def dev(
     ctx: typer.Context,
-    port: int = typer.Option(3000, "--port", help="Local server port."),
+    port: int = typer.Option(3000, "--port", help="Local server port"),
     host: str = typer.Option(
         devserver.LOCAL_HOST,
         "--host",
         help="Interface to bind. Loopback by default; pass 0.0.0.0 to expose on your network.",
     ),
-    no_open: bool = typer.Option(False, "--no-open", help="Launch, but don't open the browser."),
+    no_open: bool = typer.Option(False, "--no-open", help="Launch, but don't open the browser"),
     no_install: bool = typer.Option(
-        False, "--no-install", help="Skip dependency install; launch directly."
+        False, "--no-install", help="Skip dependency install; launch directly"
     ),
     json_out: bool = options.json_option(),
 ) -> None:
-    """Launch the dev server for the app in the current directory.
+    """Run the dev server for the app in the current directory
 
     Run this from inside a project created by `assembly init`. It installs dependencies
     if needed, then starts the FastAPI server with live reload and opens the browser.
diff --git a/aai_cli/commands/dictate/__init__.py b/aai_cli/commands/dictate/__init__.py
index 5e55dd46..ed49b6dc 100644
--- a/aai_cli/commands/dictate/__init__.py
+++ b/aai_cli/commands/dictate/__init__.py
@@ -38,28 +38,28 @@ def dictate(
         None,
         "--language",
         help="ISO 639-1 language code, or a comma-separated list for "
-        "code-switching audio (default: en).",
+        "code-switching audio (default: en)",
     ),
     prompt: str | None = typer.Option(
         None,
         "--prompt",
-        help="Custom transcription prompt (overrides --language).",
+        help="Custom transcription prompt (overrides --language)",
     ),
     word_boost: list[str] | None = typer.Option(
-        None, "--word-boost", help="Bias recognition toward a term (repeatable)."
+        None, "--word-boost", help="Bias recognition toward a term (repeatable)"
     ),
-    device: int | None = typer.Option(None, "--device", help="Microphone device index."),
-    once: bool = typer.Option(False, "--once", help="Transcribe one utterance, then exit."),
+    device: int | None = typer.Option(None, "--device", help="Microphone device index"),
+    once: bool = typer.Option(False, "--once", help="Transcribe one utterance, then exit"),
     max_seconds: float = typer.Option(
         float(MAX_AUDIO_SECONDS),
         "--max-seconds",
-        help="Auto-stop a recording after this many seconds.",
+        help="Auto-stop a recording after this many seconds",
         min=1.0,
         max=float(MAX_AUDIO_SECONDS),
     ),
-    json_out: bool = options.json_option("Emit one JSON object per utterance."),
+    json_out: bool = options.json_option("Emit one JSON object per utterance"),
 ) -> None:
-    """Dictate with a hotkey: record the mic, get the transcript back instantly.
+    """Push-to-talk dictation: record the mic, get the transcript back
 
     Press Enter (or Space) to start recording and press it again to stop; the
     utterance is sent to the AssemblyAI Sync API and the transcript prints
diff --git a/aai_cli/commands/doctor.py b/aai_cli/commands/doctor.py
index ebd334d8..b2a1aab3 100644
--- a/aai_cli/commands/doctor.py
+++ b/aai_cli/commands/doctor.py
@@ -28,7 +28,7 @@ def doctor(
     ctx: typer.Context,
     json_out: bool = options.json_option(),
 ) -> None:
-    """Check that your environment is ready to use AssemblyAI."""
+    """Check that your environment is ready for AssemblyAI"""
 
     def body(state: AppState, json_mode: bool) -> None:
         profile = state.resolve_profile()
diff --git a/aai_cli/commands/dub/__init__.py b/aai_cli/commands/dub/__init__.py
index 8a298ba7..713d18da 100644
--- a/aai_cli/commands/dub/__init__.py
+++ b/aai_cli/commands/dub/__init__.py
@@ -58,13 +58,13 @@ def dub(
     media: str = typer.Argument(
         ...,
         help="Audio/video to dub: a local file (the video stream is copied untouched), "
-        "or a YouTube/media-page URL (downloaded via yt-dlp).",
+        "or a YouTube/media-page URL (downloaded via yt-dlp)",
     ),
     lang: str = typer.Option(
         ...,
         "--lang",
         "-l",
-        help="Target language: an ISO code (de, fr, es, …) or a language name (German).",
+        help="Target language: an ISO code (de, fr, es, …) or a language name (German)",
     ),
     source_lang: str | None = typer.Option(
         None,
@@ -75,8 +75,7 @@ def dub(
         None,
         "--transcript-id",
         "-t",
-        help="Reuse an existing diarized transcript of this media instead of "
-        "transcribing it again.",
+        help="Reuse an existing diarized transcript of this media instead of transcribing it again",
     ),
     voice: list[str] = typer.Option(
         [],
@@ -88,18 +87,18 @@ def dub(
     model: str = typer.Option(
         llm.DEFAULT_MODEL,
         "--model",
-        help="LLM Gateway model that translates the utterances.",
+        help="LLM Gateway model that translates the utterances",
         rich_help_panel=help_panels.OPT_LLM,
         autocompletion=llm.complete_model,
     ),
     max_tokens: int = typer.Option(
         llm.DEFAULT_MAX_TOKENS,
         "--max-tokens",
-        help="Max tokens per utterance translation.",
+        help="Max tokens per utterance translation",
         rich_help_panel=help_panels.OPT_LLM,
     ),
     out: Path | None = typer.Option(
-        None, "--out", help="Output file (default: <name>.dub.<lang><ext> next to the input)."
+        None, "--out", help="Output file (default: <name>.dub.<lang><ext> next to the input)"
     ),
     video: bool = typer.Option(
         False,
@@ -112,11 +111,11 @@ def dub(
         "--download-sections",
         help="For a URL source, download (and dub) only part of it (yt-dlp "
         '"--download-sections" syntax, e.g. "*0:00-15:00" for the first fifteen '
-        "minutes; repeatable).",
+        "minutes; repeatable)",
     ),
-    json_out: bool = options.json_option("Emit JSON describing the dubbed file."),
+    json_out: bool = options.json_option("Emit JSON describing the dubbed file"),
 ) -> None:
-    r"""\[sandbox] Dub a video or audio file into another language.
+    r"""\[sandbox] Dub a video or audio file into another language
 
     The whole platform in one command: the media is transcribed with diarized
     utterance timestamps, each utterance is translated by an LLM Gateway model,
diff --git a/aai_cli/commands/evaluate/__init__.py b/aai_cli/commands/evaluate/__init__.py
index 94ee3562..00ce36d1 100644
--- a/aai_cli/commands/evaluate/__init__.py
+++ b/aai_cli/commands/evaluate/__init__.py
@@ -52,36 +52,36 @@ def evaluate(
     ctx: typer.Context,
     dataset: str = typer.Argument(
         ...,
-        help="Hugging Face dataset id, or a local .csv/.jsonl manifest with audio + text columns.",
+        help="Hugging Face dataset id, or a local .csv/.jsonl manifest with audio + text columns",
     ),
     split: str | None = typer.Option(
-        None, "--split", help="Hugging Face split to score (default: test)."
+        None, "--split", help="Hugging Face split to score (default: test)"
     ),
     subset: str | None = typer.Option(
-        None, "--subset", help="Hugging Face config/subset name (e.g. a language)."
+        None, "--subset", help="Hugging Face config/subset name (e.g. a language)"
     ),
-    limit: int = typer.Option(10, "--limit", min=1, max=100, help="Rows to evaluate (1-100)."),
+    limit: int = typer.Option(10, "--limit", min=1, max=100, help="Rows to evaluate (1-100)"),
     audio_column: str | None = typer.Option(
-        None, "--audio-column", help="Audio column name (default: auto-detect)."
+        None, "--audio-column", help="Audio column name (default: auto-detect)"
     ),
     text_column: str | None = typer.Option(
-        None, "--text-column", help="Reference text column name (default: auto-detect)."
+        None, "--text-column", help="Reference text column name (default: auto-detect)"
     ),
     speech_model: EvalSpeechModel | None = typer.Option(
-        None, "--speech-model", help="Speech model to evaluate."
+        None, "--speech-model", help="Speech model to evaluate"
     ),
     language_code: str | None = typer.Option(
-        None, "--language-code", help="Force a language (e.g. en_us)."
+        None, "--language-code", help="Force a language (e.g. en_us)"
     ),
     concurrency: int = typer.Option(
         1,
         "--concurrency",
         min=1,
-        help="How many items to transcribe at once (sequential by default).",
+        help="How many items to transcribe at once (sequential by default)",
     ),
-    json_out: bool = options.json_option("Output the rows and summary as one JSON object."),
+    json_out: bool = options.json_option("Output the rows and summary as one JSON object"),
 ) -> None:
-    """Transcribe an evaluation dataset and score WER against its reference texts.
+    """Transcribe a dataset and score WER against its reference texts
 
     Each row's audio is transcribed, then scored against the row's reference
     text; both are normalized first (lowercased, punctuation stripped) so style
diff --git a/aai_cli/commands/init.py b/aai_cli/commands/init.py
index 2cbb3795..f7fc972c 100644
--- a/aai_cli/commands/init.py
+++ b/aai_cli/commands/init.py
@@ -46,29 +46,29 @@ def init(
         # that actually ship.
         help=(
             f"Template to scaffold: {', '.join(templates.TEMPLATE_ORDER)} "
-            "(omit to pick interactively)."
+            "(omit to pick interactively)"
         ),
     ),
-    directory: str | None = typer.Argument(None, help="Target directory (default: <template>)."),
+    directory: str | None = typer.Argument(None, help="Target directory (default: <template>)"),
     no_install: bool = typer.Option(
-        False, "--no-install", help="Scaffold only; don't install or launch."
+        False, "--no-install", help="Scaffold only; don't install or launch"
     ),
     no_open: bool = typer.Option(
-        False, "--no-open", help="Install + launch, but don't open the browser."
+        False, "--no-open", help="Install + launch, but don't open the browser"
     ),
     force: bool = typer.Option(
         False,
         "--force",
         help=(
             "Overwrite a non-empty target directory (overlays the template; "
-            "files not in the template are kept)."
+            "files not in the template are kept)"
         ),
     ),
-    here: bool = typer.Option(False, "--here", help="Scaffold into the current directory."),
-    port: int = typer.Option(init_exec.DEFAULT_PORT, "--port", help="Local server port."),
+    here: bool = typer.Option(False, "--here", help="Scaffold into the current directory"),
+    port: int = typer.Option(init_exec.DEFAULT_PORT, "--port", help="Local server port"),
     json_out: bool = options.json_option(),
 ) -> None:
-    """Scaffold a new project from a template, then launch it.
+    """Scaffold a new app from a template and launch it
 
     This is the starting point for creating an app — including a voice agent app
     ('assembly init voice-agent'). The 'assembly agent' command only runs a live mic
diff --git a/aai_cli/commands/keys.py b/aai_cli/commands/keys.py
index 25d6ac39..b1642ec6 100644
--- a/aai_cli/commands/keys.py
+++ b/aai_cli/commands/keys.py
@@ -9,7 +9,7 @@
 from aai_cli.errors import APIError, UsageError
 from aai_cli.help_text import examples_epilog
 
-app = typer.Typer(help="List, create, and rename your AssemblyAI API keys.", no_args_is_help=True)
+app = typer.Typer(help="List, create, and rename your AssemblyAI API keys", no_args_is_help=True)
 
 SPEC = command_registry.CommandModuleSpec(
     panel=help_panels.ACCOUNT,
@@ -64,7 +64,7 @@ def list_(
     ctx: typer.Context,
     json_out: bool = options.json_option(),
 ) -> None:
-    """List API keys across your projects (keys shown masked)."""
+    """List API keys across your projects (shown masked)"""
 
     def body(state: AppState, json_mode: bool) -> None:
         account_id, jwt = state.resolve_session()
@@ -117,13 +117,13 @@ def render(data: list[dict[str, object]]) -> object:
 )
 def create(
     ctx: typer.Context,
-    name: str = typer.Option(..., "--name", help="A label for the new key."),
+    name: str = typer.Option(..., "--name", help="A label for the new key"),
     project_id: int | None = typer.Option(
-        None, "--project", help="Project id to create the key in (defaults to your first)."
+        None, "--project", help="Project id to create the key in (defaults to your first)"
     ),
     json_out: bool = options.json_option(),
 ) -> None:
-    """Create a new API key. Prints the key value once — copy it now."""
+    """Create an API key (printed once — copy it now)"""
 
     def body(state: AppState, json_mode: bool) -> None:
         # Validate locally before any auth/network work: an empty or whitespace-only
@@ -158,11 +158,11 @@ def body(state: AppState, json_mode: bool) -> None:
 )
 def rename(
     ctx: typer.Context,
-    token_id: int = typer.Argument(..., help="The key id (see `assembly keys list`)."),
-    new_name: str = typer.Argument(..., help="The new label."),
+    token_id: int = typer.Argument(..., help="The key id (see `assembly keys list`)"),
+    new_name: str = typer.Argument(..., help="The new label"),
     json_out: bool = options.json_option(),
 ) -> None:
-    """Rename an existing API key."""
+    """Rename an existing API key"""
 
     def body(state: AppState, json_mode: bool) -> None:
         account_id, jwt = state.resolve_session()
diff --git a/aai_cli/commands/llm/__init__.py b/aai_cli/commands/llm/__init__.py
index eb4025af..54b36169 100644
--- a/aai_cli/commands/llm/__init__.py
+++ b/aai_cli/commands/llm/__init__.py
@@ -49,18 +49,18 @@ def _list_models(output_field: choices.TextOrJson | None, json_mode: bool) -> No
 )
 def llm(
     ctx: typer.Context,
-    prompt: str | None = typer.Argument(None, help="The prompt to send to the model."),
+    prompt: str | None = typer.Argument(None, help="The prompt to send to the model"),
     # Note: text piped on stdin is injected into the prompt (e.g. `cat notes | assembly llm "summarize"`).
     model: str = typer.Option(
         gateway.DEFAULT_MODEL,
         "--model",
-        help="LLM Gateway model.",
+        help="LLM Gateway model",
         autocompletion=gateway.complete_model,
     ),
     transcript_id: str | None = typer.Option(
-        None, "--transcript-id", help="Inject this transcript's text into the prompt."
+        None, "--transcript-id", help="Inject this transcript's text into the prompt"
     ),
-    system: str | None = typer.Option(None, "--system", help="Optional system prompt."),
+    system: str | None = typer.Option(None, "--system", help="Optional system prompt"),
     follow: bool = typer.Option(
         False,
         "--follow",
@@ -73,10 +73,10 @@ def llm(
         None,
         "-o",
         "--output",
-        help="Print one field of the result: text (just the answer, pipe-friendly) or json.",
+        help="Print one field of the result: text (just the answer, pipe-friendly) or json",
     ),
     max_tokens: int = typer.Option(
-        gateway.DEFAULT_MAX_TOKENS, "--max-tokens", help="Max tokens to generate.", min=1
+        gateway.DEFAULT_MAX_TOKENS, "--max-tokens", help="Max tokens to generate", min=1
     ),
     config_kv: list[str] | None = typer.Option(
         None,
@@ -84,10 +84,10 @@ def llm(
         help="Set any extra gateway request field: KEY=VALUE, repeatable "
         "(e.g. --config temperature=0.2). Values parse as JSON, else literal text.",
     ),
-    list_models: bool = typer.Option(False, "--list-models", help="Print known models and exit."),
-    json_out: bool = options.json_option("Output raw JSON (one object per turn in --follow mode)."),
+    list_models: bool = typer.Option(False, "--list-models", help="Print known models and exit"),
+    json_out: bool = options.json_option("Output raw JSON (one object per turn in --follow mode)"),
 ) -> None:
-    """Send a prompt to AssemblyAI's LLM Gateway and print the response.
+    """Send a prompt to AssemblyAI's LLM Gateway and print the reply
 
     With --transcript-id the transcript's text is injected server-side, so you
     can ask questions about a past transcription (e.g. assembly llm "summarize" --transcript-id ID).
diff --git a/aai_cli/commands/login.py b/aai_cli/commands/login.py
index d4424105..dd09af53 100644
--- a/aai_cli/commands/login.py
+++ b/aai_cli/commands/login.py
@@ -66,7 +66,7 @@ def login(
         None,
         "--api-key",
         hidden=True,
-        help="Deprecated: use --with-api-key (reads stdin; keeps the key out of shell history).",
+        help="Deprecated: use --with-api-key (reads stdin; keeps the key out of shell history)",
     ),
     with_api_key: bool = typer.Option(
         False,
@@ -75,7 +75,7 @@ def login(
     ),
     json_out: bool = options.json_option(),
 ) -> None:
-    """Authenticate via your browser; stores a CLI API key."""
+    """Authenticate via your browser and store a CLI API key"""
 
     def body(state: AppState, json_mode: bool) -> None:
         profile = state.resolve_profile()
@@ -180,7 +180,7 @@ def logout(
     ctx: typer.Context,
     json_out: bool = options.json_option(),
 ) -> None:
-    """Clear stored credentials for the active profile."""
+    """Clear stored credentials for the active profile"""
 
     def body(state: AppState, json_mode: bool) -> None:
         profile = state.resolve_profile()
@@ -221,7 +221,7 @@ def whoami(
     ctx: typer.Context,
     json_out: bool = options.json_option(),
 ) -> None:
-    """Show the active profile and whether its key is usable."""
+    """Show the active profile and whether its key works"""
 
     def body(state: AppState, json_mode: bool) -> None:
         profile = state.resolve_profile()
diff --git a/aai_cli/commands/onboard.py b/aai_cli/commands/onboard.py
index 84c3e39f..b9823da6 100644
--- a/aai_cli/commands/onboard.py
+++ b/aai_cli/commands/onboard.py
@@ -43,10 +43,10 @@ def onboard(
     non_interactive: bool = typer.Option(
         False,
         "--non-interactive",
-        help="Run without interactive prompts (default when agent detected).",
+        help="Run without interactive prompts (default when agent detected)",
     ),
 ) -> None:
-    """Guided setup: sign in, run your first transcription, and start building."""
+    """Guided setup: sign in and run your first transcription"""
 
     def body(state: AppState, json_mode: bool) -> None:
         profile = state.resolve_profile()
diff --git a/aai_cli/commands/sessions.py b/aai_cli/commands/sessions.py
index 9ec79b0a..31457115 100644
--- a/aai_cli/commands/sessions.py
+++ b/aai_cli/commands/sessions.py
@@ -11,7 +11,7 @@
 from aai_cli.context import AppState, run_command
 from aai_cli.help_text import examples_epilog
 
-app = typer.Typer(help="Browse your past streaming (real-time) sessions.", no_args_is_help=True)
+app = typer.Typer(help="Browse your past streaming (real-time) sessions", no_args_is_help=True)
 
 SPEC = command_registry.CommandModuleSpec(
     panel=help_panels.HISTORY,
@@ -68,13 +68,13 @@ class SessionStatus(enum.StrEnum):
 )
 def list_(
     ctx: typer.Context,
-    limit: int = typer.Option(10, "--limit", help="How many sessions to show.", min=1),
+    limit: int = typer.Option(10, "--limit", help="How many sessions to show", min=1),
     status: SessionStatus | None = typer.Option(
-        None, "--status", help="Only show sessions with this status."
+        None, "--status", help="Only show sessions with this status"
     ),
     json_out: bool = options.json_option(),
 ) -> None:
-    """List recent streaming sessions."""
+    """List recent streaming sessions"""
 
     def body(state: AppState, json_mode: bool) -> None:
         _, jwt = state.resolve_session()
@@ -125,10 +125,10 @@ def render(data: list[dict[str, object]]) -> object:
 )
 def get(
     ctx: typer.Context,
-    session_id: str = typer.Argument(..., help="Streaming session id."),
+    session_id: str = typer.Argument(..., help="Streaming session id"),
     json_out: bool = options.json_option(),
 ) -> None:
-    """Show details for one streaming session."""
+    """Show details for one streaming session"""
 
     def body(state: AppState, json_mode: bool) -> None:
         _, jwt = state.resolve_session()
diff --git a/aai_cli/commands/setup.py b/aai_cli/commands/setup.py
index 3400f1c5..bf08bbe0 100644
--- a/aai_cli/commands/setup.py
+++ b/aai_cli/commands/setup.py
@@ -7,7 +7,7 @@
 from aai_cli.help_text import examples_epilog
 
 app = typer.Typer(
-    help="Set up your coding agent for AssemblyAI (docs MCP + skills).",
+    help="Set up your coding agent for AssemblyAI (docs MCP + skills)",
     no_args_is_help=True,
 )
 
@@ -35,10 +35,10 @@ def install(
         "--scope",
         help="Config scope to register the MCP under. Presence is detected across all scopes.",
     ),
-    force: bool = typer.Option(False, "--force", help="Reinstall even if already present."),
+    force: bool = typer.Option(False, "--force", help="Reinstall even if already present"),
     json_out: bool = options.json_option(),
 ) -> None:
-    """Set up your coding agent for AssemblyAI (docs MCP server + skills).
+    """Set up your coding agent for AssemblyAI (docs MCP + skills)
 
     Installs three things: the assemblyai-docs MCP server (live API docs, via
     `claude mcp add`), the AssemblyAI skill (via `npx skills add`), and the bundled
@@ -71,7 +71,7 @@ def status(
     ctx: typer.Context,
     json_out: bool = options.json_option(),
 ) -> None:
-    """Show whether the AssemblyAI MCP server and skills are set up in your coding agent."""
+    """Show whether the AssemblyAI MCP and skills are set up in your coding agent"""
 
     def body(_state: AppState, json_mode: bool) -> None:
         steps = [setup_exec.mcp_status(), setup_exec.skill_status(), setup_exec.cli_skill_status()]
@@ -100,7 +100,7 @@ def remove(
     ),
     json_out: bool = options.json_option(),
 ) -> None:
-    """Remove the AssemblyAI MCP server and skills from your coding agent."""
+    """Remove the AssemblyAI MCP and skills from your coding agent"""
 
     def body(_state: AppState, json_mode: bool) -> None:
         steps = [
diff --git a/aai_cli/commands/share/__init__.py b/aai_cli/commands/share/__init__.py
index 0e1eb05a..03cb955c 100644
--- a/aai_cli/commands/share/__init__.py
+++ b/aai_cli/commands/share/__init__.py
@@ -30,13 +30,13 @@
 )
 def share(
     ctx: typer.Context,
-    port: int = typer.Option(3000, "--port", help="Local server port."),
+    port: int = typer.Option(3000, "--port", help="Local server port"),
     no_install: bool = typer.Option(
-        False, "--no-install", help="Skip dependency install; launch directly."
+        False, "--no-install", help="Skip dependency install; launch directly"
     ),
     json_out: bool = options.json_option(),
 ) -> None:
-    """Boot the app and expose it on a public URL via a cloudflared tunnel.
+    """Expose the local app on a public URL via a cloudflared tunnel
 
     Run this from inside a project created by `assembly init`. It starts the dev server and
     opens a cloudflared quick tunnel, printing a shareable https://*.trycloudflare.com
diff --git a/aai_cli/commands/speak/__init__.py b/aai_cli/commands/speak/__init__.py
index 64872601..7da35b89 100644
--- a/aai_cli/commands/speak/__init__.py
+++ b/aai_cli/commands/speak/__init__.py
@@ -51,7 +51,7 @@ def speak(
         [],
         "--voice",
         help="Voice id (e.g. jane, michael, mary, paul, eve, george), or SPEAKER=VOICE "
-        "for diarized input (repeatable, e.g. --voice A=jane).",
+        "for diarized input (repeatable, e.g. --voice A=jane)",
     ),
     language: str = typer.Option(
         DEFAULT_LANGUAGE,
@@ -66,11 +66,11 @@ def speak(
         min=1,
     ),
     out: Path | None = typer.Option(
-        None, "--out", help="Write a WAV file instead of playing through the speakers."
+        None, "--out", help="Write a WAV file instead of playing through the speakers"
     ),
-    json_out: bool = options.json_option("Emit JSON metadata about the synthesized audio."),
+    json_out: bool = options.json_option("Emit JSON metadata about the synthesized audio"),
 ) -> None:
-    r"""\[sandbox] Synthesize speech from text with AssemblyAI streaming TTS.
+    r"""\[sandbox] Synthesize speech from text with AssemblyAI streaming TTS
 
     Plays the audio through your speakers by default, or writes a WAV with
     --out. Speaker-labeled input (from 'assembly transcribe
diff --git a/aai_cli/commands/stream/__init__.py b/aai_cli/commands/stream/__init__.py
index 149d5edc..78ef5772 100644
--- a/aai_cli/commands/stream/__init__.py
+++ b/aai_cli/commands/stream/__init__.py
@@ -48,66 +48,66 @@ def stream(
         help="Audio file path, URL, or YouTube/podcast page URL to stream. Use - for raw "
         "PCM16/mono/16k on stdin. Omit to use the microphone.",
     ),
-    sample: bool = typer.Option(False, "--sample", help="Stream the hosted wildfires.mp3 sample."),
+    sample: bool = typer.Option(False, "--sample", help="Stream the hosted wildfires.mp3 sample"),
     # audio capture
     sample_rate: int | None = typer.Option(
         None,
         "--sample-rate",
         help="Audio rate in Hz (positive): capture rate for the mic, or the declared "
-        "rate of raw PCM on stdin (default: device native / 16000).",
+        "rate of raw PCM on stdin (default: device native / 16000)",
         min=1,
         rich_help_panel=help_panels.OPT_CAPTURE,
     ),
     device: int | None = typer.Option(
-        None, "--device", help="Microphone device index.", rich_help_panel=help_panels.OPT_CAPTURE
+        None, "--device", help="Microphone device index", rich_help_panel=help_panels.OPT_CAPTURE
     ),
     system_audio: bool = typer.Option(
         False,
         "--system-audio",
-        help="macOS only: stream system/app audio and microphone as separate sessions.",
+        help="macOS only: stream system/app audio and microphone as separate sessions",
         rich_help_panel=help_panels.OPT_CAPTURE,
     ),
     system_audio_only: bool = typer.Option(
         False,
         "--system-audio-only",
-        help="macOS only: stream system/app audio without the microphone.",
+        help="macOS only: stream system/app audio without the microphone",
         rich_help_panel=help_panels.OPT_CAPTURE,
     ),
     # model & input
     speech_model: SpeechModel = typer.Option(
         DEFAULT_SPEECH_MODEL,
         "--speech-model",
-        help="Streaming speech model.",
+        help="Streaming speech model",
         rich_help_panel=help_panels.OPT_MODEL,
     ),
     encoding: Encoding | None = typer.Option(
         None,
         "--encoding",
-        help="Audio encoding.",
+        help="Audio encoding",
         rich_help_panel=help_panels.OPT_MODEL,
     ),
     language_detection: bool | None = typer.Option(
         None,
         "--language-detection",
-        help="Auto-detect the spoken language.",
+        help="Auto-detect the spoken language",
         rich_help_panel=help_panels.OPT_MODEL,
     ),
     domain: str | None = typer.Option(
         None,
         "--domain",
-        help="Domain preset (e.g. medical).",
+        help="Domain preset (e.g. medical)",
         rich_help_panel=help_panels.OPT_MODEL,
     ),
     prompt: str | None = typer.Option(
         None,
         "--prompt",
-        help="Prompt to bias the speech model (supported models only).",
+        help="Prompt to bias the speech model (supported models only)",
         rich_help_panel=help_panels.OPT_MODEL,
     ),
     keyterms_prompt: list[str] | None = typer.Option(
         None,
         "--keyterms-prompt",
-        help="Boost a key term (repeatable).",
+        help="Boost a key term (repeatable)",
         rich_help_panel=help_panels.OPT_MODEL,
     ),
     # turn detection
@@ -117,7 +117,7 @@ def stream(
         # un-clipped in an 80-column help screen, which made it unlearnable from --help.
         # The full SDK field stays reachable via --config.
         "--end-of-turn-confidence",
-        help="End-of-turn confidence (0-1).",
+        help="End-of-turn confidence (0-1)",
         min=0.0,
         max=1.0,
         rich_help_panel=help_panels.OPT_TURNS,
@@ -125,19 +125,19 @@ def stream(
     min_turn_silence: int | None = typer.Option(
         None,
         "--min-turn-silence",
-        help="Min silence to end a turn (ms).",
+        help="Min silence to end a turn (ms)",
         rich_help_panel=help_panels.OPT_TURNS,
     ),
     max_turn_silence: int | None = typer.Option(
         None,
         "--max-turn-silence",
-        help="Max silence before ending a turn (ms).",
+        help="Max silence before ending a turn (ms)",
         rich_help_panel=help_panels.OPT_TURNS,
     ),
     vad_threshold: float | None = typer.Option(
         None,
         "--vad-threshold",
-        help="Voice activity threshold (0-1).",
+        help="Voice activity threshold (0-1)",
         min=0.0,
         max=1.0,
         rich_help_panel=help_panels.OPT_TURNS,
@@ -145,13 +145,13 @@ def stream(
     format_turns: bool | None = typer.Option(
         None,
         "--format-turns/--no-format-turns",
-        help="Format (punctuate) finalized turns.",
+        help="Format (punctuate) finalized turns",
         rich_help_panel=help_panels.OPT_TURNS,
     ),
     include_partial_turns: bool | None = typer.Option(
         None,
         "--include-partial-turns",
-        help="Emit partial turns.",
+        help="Emit partial turns",
         rich_help_panel=help_panels.OPT_TURNS,
     ),
     # speakers
@@ -165,7 +165,7 @@ def stream(
     max_speakers: int | None = typer.Option(
         None,
         "--max-speakers",
-        help="Max speakers.",
+        help="Max speakers",
         min=1,
         rich_help_panel=help_panels.OPT_SPEAKERS,
     ),
@@ -173,13 +173,13 @@ def stream(
     voice_focus: NoiseSuppressionModel | None = typer.Option(
         None,
         "--voice-focus",
-        help="Voice focus (noise suppression model).",
+        help="Voice focus (noise suppression model)",
         rich_help_panel=help_panels.OPT_FEATURES,
     ),
     voice_focus_threshold: float | None = typer.Option(
         None,
         "--voice-focus-threshold",
-        help="Voice-focus threshold (0-1).",
+        help="Voice-focus threshold (0-1)",
         min=0.0,
         max=1.0,
         rich_help_panel=help_panels.OPT_FEATURES,
@@ -187,42 +187,42 @@ def stream(
     inactivity_timeout: int | None = typer.Option(
         None,
         "--inactivity-timeout",
-        help="Auto-close after N seconds idle.",
+        help="Auto-close after N seconds idle",
         rich_help_panel=help_panels.OPT_FEATURES,
     ),
     # guardrails
     filter_profanity: bool | None = typer.Option(
         None,
         "--filter-profanity",
-        help="Mask profanity.",
+        help="Mask profanity",
         rich_help_panel=help_panels.OPT_GUARDRAILS,
     ),
     redact_pii: bool | None = typer.Option(
         None,
         "--redact-pii",
-        help="Redact PII from turns.",
+        help="Redact PII from turns",
         rich_help_panel=help_panels.OPT_GUARDRAILS,
     ),
     redact_pii_policy: str | None = typer.Option(
         None,
         "--redact-pii-policy",
-        help="Comma-separated PII policies.",
+        help="Comma-separated PII policies",
         rich_help_panel=help_panels.OPT_GUARDRAILS,
     ),
     redact_pii_sub: str | None = typer.Option(
         None,
         "--redact-pii-sub",
-        help="Replace redacted PII with: hash or entity_name.",
+        help="Replace redacted PII with: hash or entity_name",
         rich_help_panel=help_panels.OPT_GUARDRAILS,
     ),
     # webhooks
     webhook_url: str | None = typer.Option(
-        None, "--webhook-url", help="Webhook URL.", rich_help_panel=help_panels.OPT_WEBHOOKS
+        None, "--webhook-url", help="Webhook URL", rich_help_panel=help_panels.OPT_WEBHOOKS
     ),
     webhook_auth_header: str | None = typer.Option(
         None,
         "--webhook-auth-header",
-        help="Webhook auth header as NAME:VALUE.",
+        help="Webhook auth header as NAME:VALUE",
         rich_help_panel=help_panels.OPT_WEBHOOKS,
         metavar="NAME:VALUE",
     ),
@@ -238,53 +238,53 @@ def stream(
     llm_interval: float = typer.Option(
         10.0,
         "--llm-interval",
-        help="Seconds between --llm summary refreshes (0 refreshes on every turn).",
+        help="Seconds between --llm summary refreshes (0 refreshes on every turn)",
         min=0.0,
         rich_help_panel=help_panels.OPT_LLM,
     ),
     model: str = typer.Option(
         llm.DEFAULT_MODEL,
         "--model",
-        help="LLM Gateway model.",
+        help="LLM Gateway model",
         rich_help_panel=help_panels.OPT_LLM,
         autocompletion=llm.complete_model,
     ),
     max_tokens: int = typer.Option(
         llm.DEFAULT_MAX_TOKENS,
         "--max-tokens",
-        help="Max tokens.",
+        help="Max tokens",
         rich_help_panel=help_panels.OPT_LLM,
     ),
     # escape hatch
     config_kv: list[str] | None = typer.Option(
         None,
         "--config",
-        help="Set any StreamingParameters field as KEY=VALUE (repeatable).",
+        help="Set any StreamingParameters field as KEY=VALUE (repeatable)",
         rich_help_panel=help_panels.OPT_ADVANCED,
         metavar="KEY=VALUE",
     ),
     config_file: Path | None = typer.Option(
         None,
         "--config-file",
-        help="JSON file of streaming fields.",
+        help="JSON file of streaming fields",
         rich_help_panel=help_panels.OPT_ADVANCED,
         exists=True,
         dir_okay=False,
     ),
-    json_out: bool = options.json_option("Emit newline-delimited JSON events."),
+    json_out: bool = options.json_option("Emit newline-delimited JSON events"),
     output_field: choices.TextOrJson | None = typer.Option(
         None,
         "-o",
         "--output",
-        help="Output mode: text (finalized turns as plain lines, pipe-friendly) or json.",
+        help="Output mode: text (finalized turns as plain lines, pipe-friendly) or json",
     ),
     show_code: bool = typer.Option(
         False,
         "--show-code",
-        help="Print the equivalent Python SDK code and exit (does not stream).",
+        help="Print the equivalent Python SDK code and exit (does not stream)",
     ),
 ) -> None:
-    """Transcribe live audio in real time — from your mic, a file, a URL, or a pipe.
+    """Transcribe live audio in real time from a mic, file, URL, or pipe
 
     Pass - as the source to read raw PCM16/mono/16k audio on stdin, e.g.
     ffmpeg -i input.mp4 -f s16le -ar 16000 -ac 1 - | assembly stream -.
diff --git a/aai_cli/commands/telemetry.py b/aai_cli/commands/telemetry.py
index a376b037..120bb24e 100644
--- a/aai_cli/commands/telemetry.py
+++ b/aai_cli/commands/telemetry.py
@@ -15,7 +15,7 @@
 from aai_cli.help_text import examples_epilog
 
 app = typer.Typer(
-    help="Anonymous usage telemetry: status, enable, disable.",
+    help="Anonymous usage telemetry: status, enable, disable",
     no_args_is_help=True,
 )
 
@@ -43,7 +43,7 @@ def status(
     ctx: typer.Context,
     json_out: bool = options.json_option(),
 ) -> None:
-    """Show whether anonymous usage telemetry is active, and why."""
+    """Show whether anonymous usage telemetry is active, and why"""
 
     def body(_state: AppState, json_mode: bool) -> None:
         data: dict[str, object] = {
@@ -86,7 +86,7 @@ def enable(
     ctx: typer.Context,
     json_out: bool = options.json_option(),
 ) -> None:
-    """Re-enable anonymous usage telemetry for this machine."""
+    """Re-enable anonymous usage telemetry for this machine"""
 
     def body(_state: AppState, json_mode: bool) -> None:
         config.set_telemetry_enabled(enabled=True)
@@ -111,9 +111,9 @@ def body(_state: AppState, json_mode: bool) -> None:
     ),
 )
 def flush(
-    payload: str = typer.Argument(..., help="Serialized telemetry payload (internal)."),
+    payload: str = typer.Argument(..., help="Serialized telemetry payload (internal)"),
 ) -> None:
-    """Deliver one serialized telemetry event to the intake (internal).
+    """Deliver one serialized telemetry event to the intake (internal)
 
     This is the detached flusher `telemetry.dispatch` spawns so user commands never
     wait on the network — an explicit, reviewable entry point rather than inline
@@ -130,7 +130,7 @@ def disable(
     ctx: typer.Context,
     json_out: bool = options.json_option(),
 ) -> None:
-    """Opt out of anonymous usage telemetry for this machine."""
+    """Opt out of anonymous usage telemetry for this machine"""
 
     def body(_state: AppState, json_mode: bool) -> None:
         config.set_telemetry_enabled(enabled=False)
diff --git a/aai_cli/commands/transcribe.py b/aai_cli/commands/transcribe.py
index 678fed71..2e7d483d 100644
--- a/aai_cli/commands/transcribe.py
+++ b/aai_cli/commands/transcribe.py
@@ -42,9 +42,9 @@ def transcribe(
     source: str | None = typer.Argument(
         None,
         help="Audio file, URL, YouTube/podcast URL, bucket URL (s3://, gs://, …), or a "
-        "directory/glob (batch mode).",
+        "directory/glob (batch mode)",
     ),
-    sample: bool = typer.Option(False, "--sample", help="Use the hosted wildfires.mp3 sample."),
+    sample: bool = typer.Option(False, "--sample", help="Use the hosted wildfires.mp3 sample"),
     # batch mode
     from_stdin: bool = options.batch_from_stdin_option(),
     concurrency: int = options.batch_concurrency_option(),
@@ -53,31 +53,31 @@ def transcribe(
     speech_model: aai.SpeechModel | None = typer.Option(
         None,
         "--speech-model",
-        help="Speech model.",
+        help="Speech model",
         rich_help_panel=help_panels.OPT_MODEL,
     ),
     language_code: str | None = typer.Option(
         None,
         "--language-code",
-        help="Force a language (e.g. en_us).",
+        help="Force a language (e.g. en_us)",
         rich_help_panel=help_panels.OPT_MODEL,
     ),
     language_detection: bool | None = typer.Option(
         None,
         "--language-detection",
-        help="Auto-detect the spoken language.",
+        help="Auto-detect the spoken language",
         rich_help_panel=help_panels.OPT_MODEL,
     ),
     keyterms_prompt: list[str] | None = typer.Option(
         None,
         "--keyterms-prompt",
-        help="Boost a key term (repeatable).",
+        help="Boost a key term (repeatable)",
         rich_help_panel=help_panels.OPT_MODEL,
     ),
     temperature: float | None = typer.Option(
         None,
         "--temperature",
-        help="Speech model temperature (0 most deterministic, 1 least).",
+        help="Speech model temperature (0 most deterministic, 1 least)",
         min=0.0,
         max=1.0,
         rich_help_panel=help_panels.OPT_MODEL,
@@ -85,89 +85,89 @@ def transcribe(
     prompt: str | None = typer.Option(
         None,
         "--prompt",
-        help="Prompt to bias the speech model (supported models only).",
+        help="Prompt to bias the speech model (supported models only)",
         rich_help_panel=help_panels.OPT_MODEL,
     ),
     # formatting
     punctuate: bool | None = typer.Option(
         None,
         "--punctuate/--no-punctuate",
-        help="Add punctuation.",
+        help="Add punctuation",
         rich_help_panel=help_panels.OPT_FORMATTING,
     ),
     format_text: bool | None = typer.Option(
         None,
         "--format-text/--no-format-text",
-        help="Apply text formatting (casing, numbers).",
+        help="Apply text formatting (casing, numbers)",
         rich_help_panel=help_panels.OPT_FORMATTING,
     ),
     disfluencies: bool | None = typer.Option(
         None,
         "--disfluencies",
-        help="Keep filler words (e.g. um, uh).",
+        help="Keep filler words (e.g. um, uh)",
         rich_help_panel=help_panels.OPT_FORMATTING,
     ),
     # speakers & channels
     speaker_labels: bool = typer.Option(
         False,
         "--speaker-labels",
-        help="Enable diarization.",
+        help="Enable diarization",
         rich_help_panel=help_panels.OPT_SPEAKERS,
     ),
     speakers_expected: int | None = typer.Option(
         None,
         "--speakers-expected",
-        help="Hint speaker count.",
+        help="Hint speaker count",
         min=1,
         rich_help_panel=help_panels.OPT_SPEAKERS,
     ),
     multichannel: bool | None = typer.Option(
         None,
         "--multichannel",
-        help="Transcribe each audio channel separately.",
+        help="Transcribe each audio channel separately",
         rich_help_panel=help_panels.OPT_SPEAKERS,
     ),
     # guardrails
     redact_pii: bool | None = typer.Option(
         None,
         "--redact-pii",
-        help="Redact PII from the transcript.",
+        help="Redact PII from the transcript",
         rich_help_panel=help_panels.OPT_GUARDRAILS,
     ),
     redact_pii_policy: str | None = typer.Option(
         None,
         "--redact-pii-policy",
-        help="Comma-separated PII policies (e.g. person_name,...).",
+        help="Comma-separated PII policies (e.g. person_name,...)",
         rich_help_panel=help_panels.OPT_GUARDRAILS,
     ),
     redact_pii_sub: aai.PIISubstitutionPolicy | None = typer.Option(
         None,
         "--redact-pii-sub",
-        help="How to replace redacted PII.",
+        help="How to replace redacted PII",
         rich_help_panel=help_panels.OPT_GUARDRAILS,
     ),
     redact_pii_audio: bool | None = typer.Option(
         None,
         "--redact-pii-audio",
-        help="Also redact audio.",
+        help="Also redact audio",
         rich_help_panel=help_panels.OPT_GUARDRAILS,
     ),
     filter_profanity: bool | None = typer.Option(
         None,
         "--filter-profanity",
-        help="Mask profanity.",
+        help="Mask profanity",
         rich_help_panel=help_panels.OPT_GUARDRAILS,
     ),
     content_safety: bool | None = typer.Option(
         None,
         "--content-safety",
-        help="Detect sensitive content.",
+        help="Detect sensitive content",
         rich_help_panel=help_panels.OPT_GUARDRAILS,
     ),
     content_safety_confidence: int | None = typer.Option(
         None,
         "--content-safety-confidence",
-        help="Content-safety confidence threshold (25-100).",
+        help="Content-safety confidence threshold (25-100)",
         min=25,
         max=100,
         rich_help_panel=help_panels.OPT_GUARDRAILS,
@@ -175,7 +175,7 @@ def transcribe(
     speech_threshold: float | None = typer.Option(
         None,
         "--speech-threshold",
-        help="Minimum proportion of speech required (0-1).",
+        help="Minimum proportion of speech required (0-1)",
         min=0.0,
         max=1.0,
         rich_help_panel=help_panels.OPT_GUARDRAILS,
@@ -184,59 +184,59 @@ def transcribe(
     summarization: bool | None = typer.Option(
         None,
         "--summarization",
-        help="Summarize the transcript.",
+        help="Summarize the transcript",
         rich_help_panel=help_panels.OPT_ANALYSIS,
     ),
     summary_model: aai.SummarizationModel | None = typer.Option(
         None,
         "--summary-model",
-        help="Summary model.",
+        help="Summary model",
         rich_help_panel=help_panels.OPT_ANALYSIS,
     ),
     summary_type: aai.SummarizationType | None = typer.Option(
         None,
         "--summary-type",
-        help="Summary format.",
+        help="Summary format",
         rich_help_panel=help_panels.OPT_ANALYSIS,
     ),
     auto_chapters: bool | None = typer.Option(
-        None, "--auto-chapters", help="Generate chapters.", rich_help_panel=help_panels.OPT_ANALYSIS
+        None, "--auto-chapters", help="Generate chapters", rich_help_panel=help_panels.OPT_ANALYSIS
     ),
     sentiment_analysis: bool | None = typer.Option(
         None,
         "--sentiment-analysis",
-        help="Analyze sentiment.",
+        help="Analyze sentiment",
         rich_help_panel=help_panels.OPT_ANALYSIS,
     ),
     entity_detection: bool | None = typer.Option(
         None,
         "--entity-detection",
-        help="Detect entities.",
+        help="Detect entities",
         rich_help_panel=help_panels.OPT_ANALYSIS,
     ),
     auto_highlights: bool | None = typer.Option(
         None,
         "--auto-highlights",
-        help="Detect key phrases.",
+        help="Detect key phrases",
         rich_help_panel=help_panels.OPT_ANALYSIS,
     ),
     topic_detection: bool | None = typer.Option(
         None,
         "--topic-detection",
-        help="Detect IAB topics.",
+        help="Detect IAB topics",
         rich_help_panel=help_panels.OPT_ANALYSIS,
     ),
     # customization
     word_boost: list[str] | None = typer.Option(
         None,
         "--word-boost",
-        help="Boost a word (repeatable).",
+        help="Boost a word (repeatable)",
         rich_help_panel=help_panels.OPT_CUSTOMIZATION,
     ),
     custom_spelling_file: Path | None = typer.Option(
         None,
         "--custom-spelling-file",
-        help="JSON map of custom spellings.",
+        help="JSON map of custom spellings",
         rich_help_panel=help_panels.OPT_CUSTOMIZATION,
         exists=True,
         dir_okay=False,
@@ -244,14 +244,14 @@ def transcribe(
     audio_start: int | None = typer.Option(
         None,
         "--audio-start",
-        help="Start offset in ms.",
+        help="Start offset in ms",
         min=0,
         rich_help_panel=help_panels.OPT_CUSTOMIZATION,
     ),
     audio_end: int | None = typer.Option(
         None,
         "--audio-end",
-        help="End offset in ms.",
+        help="End offset in ms",
         min=0,
         rich_help_panel=help_panels.OPT_CUSTOMIZATION,
     ),
@@ -260,20 +260,20 @@ def transcribe(
         "--download-sections",
         help="For a YouTube/podcast URL, download only part of the source (yt-dlp "
         '"--download-sections" syntax, e.g. "*0:00-5:00" for the first five minutes; '
-        "repeatable).",
+        "repeatable)",
         rich_help_panel=help_panels.OPT_CUSTOMIZATION,
     ),
     # webhooks
     webhook_url: str | None = typer.Option(
         None,
         "--webhook-url",
-        help="Webhook URL for completion (get a dev URL with `assembly webhooks listen`).",
+        help="Webhook URL for completion (get a dev URL with `assembly webhooks listen`)",
         rich_help_panel=help_panels.OPT_WEBHOOKS,
     ),
     webhook_auth_header: str | None = typer.Option(
         None,
         "--webhook-auth-header",
-        help="Webhook auth header as NAME:VALUE.",
+        help="Webhook auth header as NAME:VALUE",
         rich_help_panel=help_panels.OPT_WEBHOOKS,
         metavar="NAME:VALUE",
     ),
@@ -281,21 +281,21 @@ def transcribe(
     translate_to: list[str] | None = typer.Option(
         None,
         "--translate-to",
-        help="Translate transcript to a language (repeatable).",
+        help="Translate transcript to a language (repeatable)",
         rich_help_panel=help_panels.OPT_TRANSLATION,
     ),
     # escape hatch
     config_kv: list[str] | None = typer.Option(
         None,
         "--config",
-        help="Set any TranscriptionConfig field as KEY=VALUE (repeatable).",
+        help="Set any TranscriptionConfig field as KEY=VALUE (repeatable)",
         rich_help_panel=help_panels.OPT_ADVANCED,
         metavar="KEY=VALUE",
     ),
     config_file: Path | None = typer.Option(
         None,
         "--config-file",
-        help="JSON file of config fields.",
+        help="JSON file of config fields",
         rich_help_panel=help_panels.OPT_ADVANCED,
         exists=True,
         dir_okay=False,
@@ -311,14 +311,14 @@ def transcribe(
     model: str = typer.Option(
         llm.DEFAULT_MODEL,
         "--model",
-        help="LLM Gateway model.",
+        help="LLM Gateway model",
         rich_help_panel=help_panels.OPT_LLM,
         autocompletion=llm.complete_model,
     ),
     max_tokens: int = typer.Option(
         llm.DEFAULT_MAX_TOKENS,
         "--max-tokens",
-        help="Max tokens.",
+        help="Max tokens",
         rich_help_panel=help_panels.OPT_LLM,
     ),
     json_out: bool = options.json_option(
@@ -329,22 +329,22 @@ def transcribe(
         None,
         "-o",
         "--output",
-        help="Print one field: text, id, status, utterances, srt or vtt (captions), or json.",
+        help="Print one field: text, id, status, utterances, srt or vtt (captions), or json",
     ),
     chars_per_caption: int | None = options.chars_per_caption_option(),
     out: Path | None = typer.Option(
         None,
         "--out",
-        help="Save the result to a file instead of printing it (clean text; pairs with -o).",
+        help="Save the result to a file instead of printing it (clean text; pairs with -o)",
         dir_okay=False,
     ),
     show_code: bool = typer.Option(
         False,
         "--show-code",
-        help="Print the equivalent Python SDK code and exit (does not transcribe).",
+        help="Print the equivalent Python SDK code and exit (does not transcribe)",
     ),
 ) -> None:
-    """Transcribe an audio file, URL, or YouTube/podcast link — or a whole batch.
+    """Transcribe a file, URL, or YouTube/podcast link — or a whole batch
 
     Quickest start: assembly transcribe call.mp3 (or --sample for the hosted demo).
 
diff --git a/aai_cli/commands/transcripts.py b/aai_cli/commands/transcripts.py
index 53d54fb3..856b13fb 100644
--- a/aai_cli/commands/transcripts.py
+++ b/aai_cli/commands/transcripts.py
@@ -17,7 +17,7 @@
 from aai_cli.errors import APIError
 from aai_cli.help_text import examples_epilog
 
-app = typer.Typer(help="Browse and fetch past transcripts.", no_args_is_help=True)
+app = typer.Typer(help="Browse and fetch past transcripts", no_args_is_help=True)
 
 SPEC = command_registry.CommandModuleSpec(
     panel=help_panels.HISTORY,
@@ -46,10 +46,10 @@
 )
 def list_(
     ctx: typer.Context,
-    limit: int = typer.Option(10, "--limit", help="How many transcripts to show.", min=1),
+    limit: int = typer.Option(10, "--limit", help="How many transcripts to show", min=1),
     json_out: bool = options.json_option(),
 ) -> None:
-    """List recent transcripts."""
+    """List recent transcripts"""
 
     def body(state: AppState, json_mode: bool) -> None:
         api_key = state.resolve_api_key()
@@ -85,17 +85,17 @@ def render(data: list[dict[str, object]]) -> object:
 )
 def get(
     ctx: typer.Context,
-    transcript_id: str = typer.Argument(..., help="Transcript id."),
+    transcript_id: str = typer.Argument(..., help="Transcript id"),
     output_field: choices.TranscriptOutput | None = typer.Option(
         None,
         "-o",
         "--output",
-        help="Print one field of the result.",
+        help="Print one field of the result",
     ),
     chars_per_caption: int | None = options.chars_per_caption_option(),
     json_out: bool = options.json_option(),
 ) -> None:
-    """Fetch a past transcript by id and print its text."""
+    """Fetch a past transcript by id and print its text"""
 
     def body(state: AppState, json_mode: bool) -> None:
         # Cheap local validation first: a malformed id or flag conflict is a usage
diff --git a/aai_cli/commands/update.py b/aai_cli/commands/update.py
index d5da6ec8..7b6a83e2 100644
--- a/aai_cli/commands/update.py
+++ b/aai_cli/commands/update.py
@@ -72,11 +72,11 @@ def _run_upgrade(command: str) -> None:
 def update(
     ctx: typer.Context,
     check: bool = typer.Option(
-        False, "--check", help="Report whether a newer release exists without installing it."
+        False, "--check", help="Report whether a newer release exists without installing it"
     ),
     json_out: bool = options.json_option(),
 ) -> None:
-    """Update the CLI to the latest release via your install method (brew/pipx/uv)."""
+    """Update the CLI to the latest release (brew/pipx/uv)"""
 
     def body(_state: AppState, json_mode: bool) -> None:
         latest = _latest_version()
diff --git a/aai_cli/commands/webhooks/__init__.py b/aai_cli/commands/webhooks/__init__.py
index aabad518..1a19a3e8 100644
--- a/aai_cli/commands/webhooks/__init__.py
+++ b/aai_cli/commands/webhooks/__init__.py
@@ -8,7 +8,7 @@
 from aai_cli.context import AppState, run_command
 from aai_cli.help_text import examples_epilog
 
-app = typer.Typer(help="Receive webhook deliveries on a public dev URL.", no_args_is_help=True)
+app = typer.Typer(help="Receive webhook deliveries on a public dev URL", no_args_is_help=True)
 
 SPEC = command_registry.CommandModuleSpec(
     panel=help_panels.TRANSCRIPTION,
@@ -38,23 +38,23 @@
 def listen(
     ctx: typer.Context,
     port: int = typer.Option(
-        8989, "--port", help="Local listener port (the first free port from here)."
+        8989, "--port", help="Local listener port (the first free port from here)"
     ),
     forward_to: str | None = typer.Option(
-        None, "--forward-to", help="Re-POST each delivery to this URL (e.g. your local app)."
+        None, "--forward-to", help="Re-POST each delivery to this URL (e.g. your local app)"
     ),
     no_tunnel: bool = typer.Option(
-        False, "--no-tunnel", help="Local-only: skip the cloudflared public URL."
+        False, "--no-tunnel", help="Local-only: skip the cloudflared public URL"
     ),
     max_events: int = typer.Option(
         0,  # pragma: no mutate (0 = serve forever; only observable by never exiting)
         "--max-events",
         min=0,
-        help="Exit after this many deliveries (0 = run until Ctrl-C).",
+        help="Exit after this many deliveries (0 = run until Ctrl-C)",
     ),
-    json_out: bool = options.json_option("One NDJSON record per delivery."),
+    json_out: bool = options.json_option("One NDJSON record per delivery"),
 ) -> None:
-    """Receive AssemblyAI webhooks on a public URL and watch them arrive.
+    """Receive AssemblyAI webhooks on a public URL and watch them arrive
 
     Opens a cloudflared quick tunnel to a local listener and prints the public
     URL to pass as --webhook-url (or webhook_url in the API). Each delivery is
diff --git a/aai_cli/main.py b/aai_cli/main.py
index ab7a0c6e..a35bfc54 100644
--- a/aai_cli/main.py
+++ b/aai_cli/main.py
@@ -145,15 +145,15 @@ def _offer_or_help(ctx: typer.Context, state: AppState) -> None:
 )
 def main(
     ctx: typer.Context,
-    profile: str | None = typer.Option(None, "--profile", "-p", help="Named credential profile."),
+    profile: str | None = typer.Option(None, "--profile", "-p", help="Named credential profile"),
     env: str | None = typer.Option(
-        None, "--env", help=f"Backend environment ({', '.join(environments.ENVIRONMENTS)})."
+        None, "--env", help=f"Backend environment ({', '.join(environments.ENVIRONMENTS)})"
     ),
     sandbox: bool = typer.Option(
-        False, "--sandbox", help=f"Shortcut for --env {environments.SANDBOX_ENV}."
+        False, "--sandbox", help=f"Shortcut for --env {environments.SANDBOX_ENV}"
     ),
     quiet: bool = typer.Option(
-        False, "--quiet", "-q", help="Suppress non-essential messages (warnings, hints)."
+        False, "--quiet", "-q", help="Suppress non-essential messages (warnings, hints)"
     ),
     color: choices.ColorMode = typer.Option(
         choices.ColorMode.auto,
@@ -165,7 +165,7 @@ def main(
         "--verbose",
         "-v",
         count=True,
-        help="Log diagnostics to stderr (-v: requests, -vv: wire-level detail).",
+        help="Log diagnostics to stderr (-v: requests, -vv: wire-level detail)",
     ),
     # Underscore name: the eager callback does the work, so the parameter is intentionally
     # unused in the body (avoids ARG001 without a `del`).
@@ -173,7 +173,7 @@ def main(
         False,
         "--version",
         "-V",
-        help="Show the CLI version and exit.",
+        help="Show the CLI version and exit",
         callback=_version_callback,
         # Eager so --version short-circuits before subcommand/arg parsing — the idiomatic
         # default. The plain `assembly --version` path behaves identically with or without this,
diff --git a/aai_cli/options.py b/aai_cli/options.py
index 064467c4..a21af548 100644
--- a/aai_cli/options.py
+++ b/aai_cli/options.py
@@ -13,7 +13,7 @@
 DEFAULT_BATCH_CONCURRENCY = 4
 
 
-def json_option(help_text: str = "Output raw JSON.") -> bool:
+def json_option(help_text: str = "Output raw JSON") -> bool:
     """The standard ``--json``/``-j`` flag; pass ``help_text`` where the shape differs."""
     flag: bool = typer.Option(False, "--json", "-j", help=help_text)
     return flag
@@ -25,7 +25,7 @@ def chars_per_caption_option() -> int | None:
         None,
         "--chars-per-caption",
         min=1,
-        help="Max characters per caption line (only with -o srt or -o vtt).",
+        help="Max characters per caption line (only with -o srt or -o vtt)",
     )
     return value
 
@@ -40,7 +40,7 @@ def batch_from_stdin_option() -> bool:
         False,
         "--from-stdin",
         help="Batch mode: read audio paths/URLs from stdin, one per line "
-        "(composes with find/ls/yt-dlp output).",
+        "(composes with find/ls/yt-dlp output)",
         rich_help_panel=help_panels.OPT_BATCH,
     )
     return flag
@@ -52,7 +52,7 @@ def batch_concurrency_option() -> int:
         DEFAULT_BATCH_CONCURRENCY,
         "--concurrency",
         min=1,
-        help="How many sources to transcribe at once in batch mode.",
+        help="How many sources to transcribe at once in batch mode",
         rich_help_panel=help_panels.OPT_BATCH,
     )
     return value
@@ -63,7 +63,7 @@ def batch_force_option() -> bool:
     flag: bool = typer.Option(
         False,
         "--force",
-        help="Batch mode: re-transcribe sources whose sidecar already records a completed run.",
+        help="Batch mode: re-transcribe sources whose sidecar already records a completed run",
         rich_help_panel=help_panels.OPT_BATCH,
     )
     return flag
diff --git a/tests/__snapshots__/test_snapshots_help_account.ambr b/tests/__snapshots__/test_snapshots_help_account.ambr
index c43588a3..24e9a07b 100644
--- a/tests/__snapshots__/test_snapshots_help_account.ambr
+++ b/tests/__snapshots__/test_snapshots_help_account.ambr
@@ -4,16 +4,15 @@
   
    Usage: assembly audit [OPTIONS]
   
-   List recent audit-log entries for your account.
+   List recent audit-log entries for your account
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --limit                   INTEGER RANGE [x>=1]  How many entries to show.    │
+  │ --limit                   INTEGER RANGE [x>=1]  How many entries to show     │
   │                                                 [default: 20]                │
-  │ --action                  TEXT                  Filter by raw action name.   │
-  │ --resource                TEXT                  Filter by raw resource type. │
-  │ --include-logins                                Show successful login        │
-  │                                                 events.                      │
-  │ --json            -j                            Output raw JSON.             │
+  │ --action                  TEXT                  Filter by raw action name    │
+  │ --resource                TEXT                  Filter by raw resource type  │
+  │ --include-logins                                Show successful login events │
+  │ --json            -j                            Output raw JSON              │
   │ --help                                          Show this message and exit.  │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -38,10 +37,10 @@
   
    Usage: assembly balance [OPTIONS]
   
-   Show your remaining account balance.
+   Show your remaining account balance
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --json  -j        Output raw JSON.                                           │
+  │ --json  -j        Output raw JSON                                            │
   │ --help            Show this message and exit.                                │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -60,13 +59,13 @@
   
    Usage: assembly keys create [OPTIONS]
   
-   Create a new API key. Prints the key value once — copy it now.
+   Create an API key (printed once — copy it now)
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ *  --name             TEXT     A label for the new key. [required]           │
+  │ *  --name             TEXT     A label for the new key [required]            │
   │    --project          INTEGER  Project id to create the key in (defaults to  │
-  │                                your first).                                  │
-  │    --json     -j               Output raw JSON.                              │
+  │                                your first)                                   │
+  │    --json     -j               Output raw JSON                               │
   │    --help                      Show this message and exit.                   │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -88,10 +87,10 @@
   
    Usage: assembly keys list [OPTIONS]
   
-   List API keys across your projects (keys shown masked).
+   List API keys across your projects (shown masked)
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --json  -j        Output raw JSON.                                           │
+  │ --json  -j        Output raw JSON                                            │
   │ --help            Show this message and exit.                                │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -112,15 +111,14 @@
   
    Usage: assembly keys rename [OPTIONS] TOKEN_ID NEW_NAME
   
-   Rename an existing API key.
+   Rename an existing API key
   
   ╭─ Arguments ──────────────────────────────────────────────────────────────────╮
-  │ *    token_id      INTEGER  The key id (see `assembly keys list`).           │
-  │                             [required]                                       │
-  │ *    new_name      TEXT     The new label. [required]                        │
+  │ *    token_id      INTEGER  The key id (see `assembly keys list`) [required] │
+  │ *    new_name      TEXT     The new label [required]                         │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --json  -j        Output raw JSON.                                           │
+  │ --json  -j        Output raw JSON                                            │
   │ --help            Show this message and exit.                                │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -137,10 +135,10 @@
   
    Usage: assembly limits [OPTIONS]
   
-   Show your account's rate limits per service.
+   Show your account's rate limits per service
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --json  -j        Output raw JSON.                                           │
+  │ --json  -j        Output raw JSON                                            │
   │ --help            Show this message and exit.                                │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -159,13 +157,13 @@
   
    Usage: assembly login [OPTIONS]
   
-   Authenticate via your browser; stores a CLI API key.
+   Authenticate via your browser and store a CLI API key
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
   │ --with-api-key            Read an API key from stdin instead of the browser  │
   │                           flow: printenv ASSEMBLYAI_API_KEY | assembly login │
   │                           --with-api-key                                     │
-  │ --json          -j        Output raw JSON.                                   │
+  │ --json          -j        Output raw JSON                                    │
   │ --help                    Show this message and exit.                        │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -184,10 +182,10 @@
   
    Usage: assembly logout [OPTIONS]
   
-   Clear stored credentials for the active profile.
+   Clear stored credentials for the active profile
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --json  -j        Output raw JSON.                                           │
+  │ --json  -j        Output raw JSON                                            │
   │ --help            Show this message and exit.                                │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -204,16 +202,16 @@
   
    Usage: assembly usage [OPTIONS]
   
-   Show usage over a date range (defaults to the last 30 days).
+   Show usage over a date range (default: last 30 days)
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
   │ --start                       TEXT  Start date (YYYY-MM-DD). Default: 30d    │
   │                                     ago.                                     │
   │ --end                         TEXT  End date (YYYY-MM-DD). Default: today.   │
-  │ --window                      TEXT  Window size: 'day', 'week', or 'month'.  │
+  │ --window                      TEXT  Window size: 'day', 'week', or 'month'   │
   │ --include-zero,--all                Include zero-usage windows (matches      │
-  │                                     --include-logins on `assembly audit`).   │
-  │ --json                -j            Output raw JSON.                         │
+  │                                     --include-logins on `assembly audit`)    │
+  │ --json                -j            Output raw JSON                          │
   │ --help                              Show this message and exit.              │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -236,10 +234,10 @@
   
    Usage: assembly whoami [OPTIONS]
   
-   Show the active profile and whether its key is usable.
+   Show the active profile and whether its key works
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --json  -j        Output raw JSON.                                           │
+  │ --json  -j        Output raw JSON                                            │
   │ --help            Show this message and exit.                                │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
diff --git a/tests/__snapshots__/test_snapshots_help_build.ambr b/tests/__snapshots__/test_snapshots_help_build.ambr
index 086558a9..2d42f2f4 100644
--- a/tests/__snapshots__/test_snapshots_help_build.ambr
+++ b/tests/__snapshots__/test_snapshots_help_build.ambr
@@ -4,19 +4,19 @@
   
    Usage: assembly deploy [OPTIONS]
   
-   Deploy the current project to Vercel (default), Railway, or Fly.io.
+   Deploy the current project to Vercel, Railway, or Fly.io
   
    Asks for confirmation first, then runs the target's CLI (`vercel deploy`,
    `railway up`, or `fly launch`). Requires that target's CLI to be installed.
    (Render deploys from a connected Git repo — see the project README.)
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --prod               Deploy to production (Vercel only).                     │
-  │ --vercel             Deploy to Vercel (the default).                         │
-  │ --railway            Deploy to Railway.                                      │
-  │ --fly                Deploy to Fly.io.                                       │
-  │ --yes      -y        Skip the confirmation prompt.                           │
-  │ --json     -j        Output raw JSON.                                        │
+  │ --prod               Deploy to production (Vercel only)                      │
+  │ --vercel             Deploy to Vercel (the default)                          │
+  │ --railway            Deploy to Railway                                       │
+  │ --fly                Deploy to Fly.io                                        │
+  │ --yes      -y        Skip the confirmation prompt                            │
+  │ --json     -j        Output raw JSON                                         │
   │ --help               Show this message and exit.                             │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -39,7 +39,7 @@
   
    Usage: assembly dev [OPTIONS]
   
-   Launch the dev server for the app in the current directory.
+   Run the dev server for the app in the current directory
   
    Run this from inside a project created by `assembly init`. It installs
    dependencies
@@ -47,13 +47,13 @@
    browser.
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --port                INTEGER  Local server port. [default: 3000]            │
+  │ --port                INTEGER  Local server port [default: 3000]             │
   │ --host                TEXT     Interface to bind. Loopback by default; pass  │
   │                                0.0.0.0 to expose on your network.            │
   │                                [default: 127.0.0.1]                          │
-  │ --no-open                      Launch, but don't open the browser.           │
-  │ --no-install                   Skip dependency install; launch directly.     │
-  │ --json        -j               Output raw JSON.                              │
+  │ --no-open                      Launch, but don't open the browser            │
+  │ --no-install                   Skip dependency install; launch directly      │
+  │ --json        -j               Output raw JSON                               │
   │ --help                         Show this message and exit.                   │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -76,7 +76,7 @@
   
    Usage: assembly init [OPTIONS] [TEMPLATE] [DIRECTORY]
   
-   Scaffold a new project from a template, then launch it.
+   Scaffold a new app from a template and launch it
   
    This is the starting point for creating an app — including a voice agent app
    ('assembly init voice-agent'). The 'assembly agent' command only runs a live
@@ -86,18 +86,18 @@
   ╭─ Arguments ──────────────────────────────────────────────────────────────────╮
   │   template       [TEMPLATE]   Template to scaffold: audio-transcription,     │
   │                               live-captions, voice-agent (omit to pick       │
-  │                               interactively).                                │
-  │   directory      [DIRECTORY]  Target directory (default: <template>).        │
+  │                               interactively)                                 │
+  │   directory      [DIRECTORY]  Target directory (default: <template>)         │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --no-install                   Scaffold only; don't install or launch.       │
-  │ --no-open                      Install + launch, but don't open the browser. │
+  │ --no-install                   Scaffold only; don't install or launch        │
+  │ --no-open                      Install + launch, but don't open the browser  │
   │ --force                        Overwrite a non-empty target directory        │
   │                                (overlays the template; files not in the      │
-  │                                template are kept).                           │
-  │ --here                         Scaffold into the current directory.          │
-  │ --port                INTEGER  Local server port. [default: 3000]            │
-  │ --json        -j               Output raw JSON.                              │
+  │                                template are kept)                            │
+  │ --here                         Scaffold into the current directory           │
+  │ --port                INTEGER  Local server port [default: 3000]             │
+  │ --json        -j               Output raw JSON                               │
   │ --help                         Show this message and exit.                   │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -122,12 +122,12 @@
   
    Usage: assembly onboard [OPTIONS]
   
-   Guided setup: sign in, run your first transcription, and start building.
+   Guided setup: sign in and run your first transcription
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --json             -j        Output raw JSON.                                │
+  │ --json             -j        Output raw JSON                                 │
   │ --non-interactive            Run without interactive prompts (default when   │
-  │                              agent detected).                                │
+  │                              agent detected)                                 │
   │ --help                       Show this message and exit.                     │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -144,7 +144,7 @@
   
    Usage: assembly share [OPTIONS]
   
-   Boot the app and expose it on a public URL via a cloudflared tunnel.
+   Expose the local app on a public URL via a cloudflared tunnel
   
    Run this from inside a project created by `assembly init`. It starts the dev
    server and
@@ -155,9 +155,9 @@
    downloads/).
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --port                INTEGER  Local server port. [default: 3000]            │
-  │ --no-install                   Skip dependency install; launch directly.     │
-  │ --json        -j               Output raw JSON.                              │
+  │ --port                INTEGER  Local server port [default: 3000]             │
+  │ --no-install                   Skip dependency install; launch directly      │
+  │ --json        -j               Output raw JSON                               │
   │ --help                         Show this message and exit.                   │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
diff --git a/tests/__snapshots__/test_snapshots_help_history.ambr b/tests/__snapshots__/test_snapshots_help_history.ambr
index 2cf6fce1..7cd73176 100644
--- a/tests/__snapshots__/test_snapshots_help_history.ambr
+++ b/tests/__snapshots__/test_snapshots_help_history.ambr
@@ -4,13 +4,13 @@
   
    Usage: assembly sessions get [OPTIONS] SESSION_ID
   
-   Show details for one streaming session.
+   Show details for one streaming session
   
   ╭─ Arguments ──────────────────────────────────────────────────────────────────╮
-  │ *    session_id      TEXT  Streaming session id. [required]                  │
+  │ *    session_id      TEXT  Streaming session id [required]                   │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --json  -j        Output raw JSON.                                           │
+  │ --json  -j        Output raw JSON                                            │
   │ --help            Show this message and exit.                                │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -32,14 +32,14 @@
   
    Usage: assembly sessions list [OPTIONS]
   
-   List recent streaming sessions.
+   List recent streaming sessions
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --limit           INTEGER RANGE [x>=1]       How many sessions to show.      │
+  │ --limit           INTEGER RANGE [x>=1]       How many sessions to show       │
   │                                              [default: 10]                   │
   │ --status          [created|completed|error]  Only show sessions with this    │
-  │                                              status.                         │
-  │ --json    -j                                 Output raw JSON.                │
+  │                                              status                          │
+  │ --json    -j                                 Output raw JSON                 │
   │ --help                                       Show this message and exit.     │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -63,18 +63,18 @@
   
    Usage: assembly transcripts get [OPTIONS] TRANSCRIPT_ID
   
-   Fetch a past transcript by id and print its text.
+   Fetch a past transcript by id and print its text
   
   ╭─ Arguments ──────────────────────────────────────────────────────────────────╮
-  │ *    transcript_id      TEXT  Transcript id. [required]                      │
+  │ *    transcript_id      TEXT  Transcript id [required]                       │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
   │ --output             -o      [text|id|status|uttera  Print one field of the  │
-  │                              nces|srt|vtt|json]      result.                 │
+  │                              nces|srt|vtt|json]      result                  │
   │ --chars-per-caption          INTEGER RANGE [x>=1]    Max characters per      │
   │                                                      caption line (only with │
-  │                                                      -o srt or -o vtt).      │
-  │ --json               -j                              Output raw JSON.        │
+  │                                                      -o srt or -o vtt)       │
+  │ --json               -j                              Output raw JSON         │
   │ --help                                               Show this message and   │
   │                                                      exit.                   │
   ╰──────────────────────────────────────────────────────────────────────────────╯
@@ -100,12 +100,12 @@
   
    Usage: assembly transcripts list [OPTIONS]
   
-   List recent transcripts.
+   List recent transcripts
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --limit          INTEGER RANGE [x>=1]  How many transcripts to show.         │
+  │ --limit          INTEGER RANGE [x>=1]  How many transcripts to show          │
   │                                        [default: 10]                         │
-  │ --json   -j                            Output raw JSON.                      │
+  │ --json   -j                            Output raw JSON                       │
   │ --help                                 Show this message and exit.           │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
diff --git a/tests/__snapshots__/test_snapshots_help_root.ambr b/tests/__snapshots__/test_snapshots_help_root.ambr
index 475ca583..742790c9 100644
--- a/tests/__snapshots__/test_snapshots_help_root.ambr
+++ b/tests/__snapshots__/test_snapshots_help_root.ambr
@@ -5,14 +5,14 @@
    Usage: assembly [OPTIONS] COMMAND [ARGS]...
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --profile             -p      TEXT                 Named credential profile. │
+  │ --profile             -p      TEXT                 Named credential profile  │
   │ --env                         TEXT                 Backend environment       │
-  │                                                    (production, sandbox000). │
+  │                                                    (production, sandbox000)  │
   │ --sandbox                                          Shortcut for --env        │
-  │                                                    sandbox000.               │
+  │                                                    sandbox000                │
   │ --quiet               -q                           Suppress non-essential    │
   │                                                    messages (warnings,       │
-  │                                                    hints).                   │
+  │                                                    hints)                    │
   │ --color                       [auto|always|never]  Color output: auto (TTY   │
   │                                                    detection), always, or    │
   │                                                    never. NO_COLOR is also   │
@@ -20,10 +20,10 @@
   │                                                    [default: auto]           │
   │ --verbose             -v      INTEGER              Log diagnostics to stderr │
   │                                                    (-v: requests, -vv:       │
-  │                                                    wire-level detail).       │
+  │                                                    wire-level detail)        │
   │                                                    [default: 0]              │
   │ --version             -V                           Show the CLI version and  │
-  │                                                    exit.                     │
+  │                                                    exit                      │
   │ --install-completion                               Install completion for    │
   │                                                    the current shell.        │
   │ --show-completion                                  Show completion for the   │
@@ -32,60 +32,52 @@
   │                                                    exit.                     │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Quick Start ────────────────────────────────────────────────────────────────╮
-  │ onboard      Guided setup: sign in, run your first transcription, and start  │
-  │              building.                                                       │
+  │ onboard      Guided setup: sign in and run your first transcription          │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Build an App ───────────────────────────────────────────────────────────────╮
-  │ init         Scaffold a new project from a template, then launch it.         │
-  │ dev          Launch the dev server for the app in the current directory.     │
-  │ share        Boot the app and expose it on a public URL via a cloudflared    │
-  │              tunnel.                                                         │
-  │ deploy       Deploy the current project to Vercel (default), Railway, or     │
-  │              Fly.io.                                                         │
+  │ init         Scaffold a new app from a template and launch it                │
+  │ dev          Run the dev server for the app in the current directory         │
+  │ share        Expose the local app on a public URL via a cloudflared tunnel   │
+  │ deploy       Deploy the current project to Vercel, Railway, or Fly.io        │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Run AssemblyAI ─────────────────────────────────────────────────────────────╮
-  │ transcribe   Transcribe an audio file, URL, or YouTube/podcast link — or a   │
-  │              whole batch.                                                    │
-  │ stream       Transcribe live audio in real time — from your mic, a file, a   │
-  │              URL, or a pipe.                                                 │
-  │ dictate      Dictate with a hotkey: record the mic, get the transcript back  │
-  │              instantly.                                                      │
-  │ agent        Have a live two-way voice conversation with an AssemblyAI voice │
-  │              agent.                                                          │
+  │ transcribe   Transcribe a file, URL, or YouTube/podcast link — or a whole    │
+  │              batch                                                           │
+  │ stream       Transcribe live audio in real time from a mic, file, URL, or    │
+  │              pipe                                                            │
+  │ dictate      Push-to-talk dictation: record the mic, get the transcript back │
+  │ agent        Hold a live two-way voice conversation with a voice agent       │
   │ speak        [sandbox] Synthesize speech from text with AssemblyAI streaming │
-  │              TTS.                                                            │
-  │ llm          Send a prompt to AssemblyAI's LLM Gateway and print the         │
-  │              response.                                                       │
-  │ clip         Cut clips out of a media file by speaker, text match, LLM pick, │
-  │              or time range.                                                  │
-  │ dub          [sandbox] Dub a video or audio file into another language.      │
-  │ caption      Burn always-visible captions into a video.                      │
-  │ eval         Transcribe an evaluation dataset and score WER against its      │
-  │              reference texts.                                                │
-  │ webhooks     Receive webhook deliveries on a public dev URL.                 │
+  │              TTS                                                             │
+  │ llm          Send a prompt to AssemblyAI's LLM Gateway and print the reply   │
+  │ clip         Cut clips from media by speaker, text match, LLM pick, or time  │
+  │              range                                                           │
+  │ dub          [sandbox] Dub a video or audio file into another language       │
+  │ caption      Burn always-visible captions into a video                       │
+  │ eval         Transcribe a dataset and score WER against its reference texts  │
+  │ webhooks     Receive webhook deliveries on a public dev URL                  │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Setup & Tools ──────────────────────────────────────────────────────────────╮
-  │ doctor       Check that your environment is ready to use AssemblyAI.         │
-  │ setup        Set up your coding agent for AssemblyAI (docs MCP + skills).    │
+  │ doctor       Check that your environment is ready for AssemblyAI             │
+  │ setup        Set up your coding agent for AssemblyAI (docs MCP + skills)     │
   │ config       Inspect and edit persisted CLI settings (profiles, env,         │
-  │              telemetry).                                                     │
-  │ update       Update the CLI to the latest release via your install method    │
-  │              (brew/pipx/uv).                                                 │
-  │ telemetry    Anonymous usage telemetry: status, enable, disable.             │
+  │              telemetry)                                                      │
+  │ update       Update the CLI to the latest release (brew/pipx/uv)             │
+  │ telemetry    Anonymous usage telemetry: status, enable, disable              │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ History ────────────────────────────────────────────────────────────────────╮
-  │ transcripts  Browse and fetch past transcripts.                              │
-  │ sessions     Browse your past streaming (real-time) sessions.                │
+  │ transcripts  Browse and fetch past transcripts                               │
+  │ sessions     Browse your past streaming (real-time) sessions                 │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Account ────────────────────────────────────────────────────────────────────╮
-  │ login        Authenticate via your browser; stores a CLI API key.            │
-  │ logout       Clear stored credentials for the active profile.                │
-  │ whoami       Show the active profile and whether its key is usable.          │
-  │ balance      Show your remaining account balance.                            │
-  │ usage        Show usage over a date range (defaults to the last 30 days).    │
-  │ limits       Show your account's rate limits per service.                    │
-  │ keys         List, create, and rename your AssemblyAI API keys.              │
-  │ audit        List recent audit-log entries for your account.                 │
+  │ login        Authenticate via your browser and store a CLI API key           │
+  │ logout       Clear stored credentials for the active profile                 │
+  │ whoami       Show the active profile and whether its key works               │
+  │ balance      Show your remaining account balance                             │
+  │ usage        Show usage over a date range (default: last 30 days)            │
+  │ limits       Show your account's rate limits per service                     │
+  │ keys         List, create, and rename your AssemblyAI API keys               │
+  │ audit        List recent audit-log entries for your account                  │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
    Examples
diff --git a/tests/__snapshots__/test_snapshots_help_run.ambr b/tests/__snapshots__/test_snapshots_help_run.ambr
index 6c07de0e..9de67337 100644
--- a/tests/__snapshots__/test_snapshots_help_run.ambr
+++ b/tests/__snapshots__/test_snapshots_help_run.ambr
@@ -4,7 +4,7 @@
   
    Usage: assembly agent [OPTIONS] [SOURCE]
   
-   Have a live two-way voice conversation with an AssemblyAI voice agent.
+   Hold a live two-way voice conversation with a voice agent
   
    Use headphones: the mic stays open while the agent speaks, so on
    speakers it would hear itself and loop. Pass an audio file/URL (or
@@ -20,11 +20,11 @@
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
   │ --sample                                   Speak the hosted wildfires.mp3    │
-  │                                            sample to the agent.              │
+  │                                            sample to the agent               │
   │ --voice                       TEXT         Agent voice. See --list-voices.   │
   │                                            [default: ivy]                    │
   │ --system-prompt               TEXT         System prompt (the agent's        │
-  │                                            persona).                         │
+  │                                            persona)                          │
   │                                            [default: You are a friendly      │
   │                                            voice assistant having a casual   │
   │                                            conversation. Keep replies short  │
@@ -34,20 +34,20 @@
   │                                            relaxed, low-key, no exclamation  │
   │                                            marks.]                           │
   │ --system-prompt-file          FILE         Read the system prompt from a     │
-  │                                            file (overrides --system-prompt). │
-  │ --greeting                    TEXT         Spoken greeting.                  │
+  │                                            file (overrides --system-prompt)  │
+  │ --greeting                    TEXT         Spoken greeting                   │
   │                                            [default: Hey, what's on your     │
   │                                            mind?]                            │
-  │ --device                      INTEGER      Microphone device index.          │
-  │ --list-voices                              Print known voices and exit.      │
+  │ --device                      INTEGER      Microphone device index           │
+  │ --list-voices                              Print known voices and exit       │
   │ --json                -j                   Emit newline-delimited JSON       │
-  │                                            events.                           │
+  │                                            events                            │
   │ --output              -o      [text|json]  Output mode: text (you:/agent:    │
   │                                            lines as plain stdout,            │
-  │                                            pipe-friendly) or json.           │
+  │                                            pipe-friendly) or json            │
   │ --show-code                                Print the equivalent Python SDK   │
   │                                            code and exit (does not start a   │
-  │                                            session).                         │
+  │                                            session)                          │
   │ --help                                     Show this message and exit.       │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -72,7 +72,7 @@
   
    Usage: assembly caption [OPTIONS] MEDIA
   
-   Burn always-visible captions into a video.
+   Burn always-visible captions into a video
   
    The video is transcribed (or an existing transcript is reused with
    --transcript-id), the transcript's SRT captions are fetched, and ffmpeg
@@ -84,25 +84,25 @@
   ╭─ Arguments ──────────────────────────────────────────────────────────────────╮
   │ *    media      TEXT  Video to caption: a local file, or a                   │
   │                       YouTube/media-page URL (the full video is downloaded   │
-  │                       via yt-dlp).                                           │
+  │                       via yt-dlp)                                            │
   │                       [required]                                             │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
   │ --transcript-id      -t      TEXT                  Reuse an existing         │
   │                                                    transcript of this media  │
   │                                                    instead of transcribing   │
-  │                                                    it again.                 │
+  │                                                    it again                  │
   │ --chars-per-caption          INTEGER RANGE [x>=1]  Max characters per        │
-  │                                                    caption line.             │
+  │                                                    caption line              │
   │ --font-size                  INTEGER RANGE [x>=1]  Font size of the          │
   │                                                    burned-in captions        │
   │                                                    (ffmpeg's default styling │
-  │                                                    when omitted).            │
+  │                                                    when omitted)             │
   │ --out                        PATH                  Output file (default:     │
   │                                                    <name>.captioned<ext>     │
-  │                                                    next to the input).       │
+  │                                                    next to the input)        │
   │ --json               -j                            Emit JSON describing the  │
-  │                                                    captioned file.           │
+  │                                                    captioned file            │
   │ --help                                             Show this message and     │
   │                                                    exit.                     │
   ╰──────────────────────────────────────────────────────────────────────────────╯
@@ -128,7 +128,7 @@
   
    Usage: assembly clip [OPTIONS] MEDIA
   
-   Cut clips out of a media file by speaker, text match, LLM pick, or time range.
+   Cut clips from media by speaker, text match, LLM pick, or time range
   
    --speaker and --search select from a diarized transcript (made on the fly,
    or reused with --transcript-id); --llm has an LLM Gateway model pick the
@@ -141,7 +141,7 @@
   
   ╭─ Arguments ──────────────────────────────────────────────────────────────────╮
   │ *    media      TEXT  Audio/video to cut clips from: a local file, or a      │
-  │                       YouTube/media-page URL (audio downloaded via yt-dlp).  │
+  │                       YouTube/media-page URL (audio downloaded via yt-dlp)   │
   │                       [required]                                             │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
@@ -152,23 +152,23 @@
   │                                                         again: an id, or '-' │
   │                                                         to read an id or     │
   │                                                         'transcribe --json'  │
-  │                                                         output from stdin.   │
+  │                                                         output from stdin    │
   │ --speaker                         TEXT                  Keep segments spoken │
   │                                                         by this diarized     │
   │                                                         speaker label        │
   │                                                         (repeatable, e.g.    │
-  │                                                         --speaker A).        │
+  │                                                         --speaker A)         │
   │ --search                          TEXT                  Keep segments whose  │
   │                                                         text contains this   │
-  │                                                         (case-insensitive).  │
+  │                                                         (case-insensitive)   │
   │ --range                           TEXT                  Keep an explicit     │
   │                                                         START-END window     │
   │                                                         (seconds or          │
   │                                                         [HH:]MM:SS;          │
-  │                                                         repeatable).         │
+  │                                                         repeatable)          │
   │ --padding                         FLOAT RANGE [x>=0.0]  Seconds of padding   │
   │                                                         to add around each   │
-  │                                                         clip.                │
+  │                                                         clip                 │
   │                                                         [default: 0.0]       │
   │ --snap               --no-snap                          Snap clip boundaries │
   │                                                         into nearby silence  │
@@ -177,11 +177,11 @@
   │                                                         don't land mid-word; │
   │                                                         --no-snap cuts at    │
   │                                                         the exact selected   │
-  │                                                         times.               │
+  │                                                         times                │
   │                                                         [default: snap]      │
   │ --out-dir                         PATH                  Directory for the    │
   │                                                         clip files (default: │
-  │                                                         next to the input).  │
+  │                                                         next to the input)   │
   │ --video                                                 Download the full    │
   │                                                         video (not just the  │
   │                                                         audio track) for a   │
@@ -191,7 +191,7 @@
   │                                                         files keep their     │
   │                                                         video already.       │
   │ --json           -j                                     Emit JSON describing │
-  │                                                         the clips written.   │
+  │                                                         the clips written    │
   │ --help                                                  Show this message    │
   │                                                         and exit.            │
   ╰──────────────────────────────────────────────────────────────────────────────╯
@@ -200,9 +200,9 @@
   │                              clip from the timestamped transcript (e.g.      │
   │                              --llm "the funniest moments"). Composes with    │
   │                              --speaker/--search.                             │
-  │ --model             TEXT     LLM Gateway model for --llm.                    │
+  │ --model             TEXT     LLM Gateway model for --llm                     │
   │                              [default: claude-haiku-4-5-20251001]            │
-  │ --max-tokens        INTEGER  Max tokens for the --llm selection reply.       │
+  │ --max-tokens        INTEGER  Max tokens for the --llm selection reply        │
   │                              [default: 1000]                                 │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -237,7 +237,7 @@
   
    Usage: assembly dictate [OPTIONS]
   
-   Dictate with a hotkey: record the mic, get the transcript back instantly.
+   Push-to-talk dictation: record the mic, get the transcript back
   
    Press Enter (or Space) to start recording and press it again to stop; the
    utterance is sent to the AssemblyAI Sync API and the transcript prints
@@ -248,20 +248,20 @@
   │ --language             TEXT                       ISO 639-1 language code,   │
   │                                                   or a comma-separated list  │
   │                                                   for code-switching audio   │
-  │                                                   (default: en).             │
+  │                                                   (default: en)              │
   │ --prompt               TEXT                       Custom transcription       │
   │                                                   prompt (overrides          │
-  │                                                   --language).               │
+  │                                                   --language)                │
   │ --word-boost           TEXT                       Bias recognition toward a  │
-  │                                                   term (repeatable).         │
-  │ --device               INTEGER                    Microphone device index.   │
+  │                                                   term (repeatable)          │
+  │ --device               INTEGER                    Microphone device index    │
   │ --once                                            Transcribe one utterance,  │
-  │                                                   then exit.                 │
+  │                                                   then exit                  │
   │ --max-seconds          FLOAT RANGE                Auto-stop a recording      │
-  │                        [1.0<=x<=120.0]            after this many seconds.   │
+  │                        [1.0<=x<=120.0]            after this many seconds    │
   │                                                   [default: 120.0]           │
   │ --json         -j                                 Emit one JSON object per   │
-  │                                                   utterance.                 │
+  │                                                   utterance                  │
   │ --help                                            Show this message and      │
   │                                                   exit.                      │
   ╰──────────────────────────────────────────────────────────────────────────────╯
@@ -287,7 +287,7 @@
   
    Usage: assembly dub [OPTIONS] MEDIA
   
-   [sandbox] Dub a video or audio file into another language.
+   [sandbox] Dub a video or audio file into another language
   
    The whole platform in one command: the media is transcribed with diarized
    utterance timestamps, each utterance is translated by an LLM Gateway model,
@@ -302,19 +302,19 @@
   ╭─ Arguments ──────────────────────────────────────────────────────────────────╮
   │ *    media      TEXT  Audio/video to dub: a local file (the video stream is  │
   │                       copied untouched), or a YouTube/media-page URL         │
-  │                       (downloaded via yt-dlp).                               │
+  │                       (downloaded via yt-dlp)                                │
   │                       [required]                                             │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
   │ *  --lang               -l      TEXT  Target language: an ISO code (de, fr,  │
-  │                                       es, …) or a language name (German).    │
+  │                                       es, …) or a language name (German)     │
   │                                       [required]                             │
   │    --source-lang                TEXT  ISO code of the source audio (e.g.     │
   │                                       de). Default: auto-detect the          │
   │                                       language.                              │
   │    --transcript-id      -t      TEXT  Reuse an existing diarized transcript  │
   │                                       of this media instead of transcribing  │
-  │                                       it again.                              │
+  │                                       it again                               │
   │    --voice                      TEXT  Voice id for every speaker (e.g. jane, │
   │                                       michael, paul), or SPEAKER=VOICE to    │
   │                                       pin a diarized speaker (repeatable,    │
@@ -322,7 +322,7 @@
   │                                       target language's native voice(s).     │
   │    --out                        PATH  Output file (default:                  │
   │                                       <name>.dub.<lang><ext> next to the     │
-  │                                       input).                                │
+  │                                       input)                                 │
   │    --video                            Download the full video (not just the  │
   │                                       audio track) for a URL source, so the  │
   │                                       dub keeps the picture. Local files     │
@@ -331,15 +331,15 @@
   │                                       only part of it (yt-dlp                │
   │                                       "--download-sections" syntax, e.g.     │
   │                                       "*0:00-15:00" for the first fifteen    │
-  │                                       minutes; repeatable).                  │
-  │    --json               -j            Emit JSON describing the dubbed file.  │
+  │                                       minutes; repeatable)                   │
+  │    --json               -j            Emit JSON describing the dubbed file   │
   │    --help                             Show this message and exit.            │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ LLM Transform ──────────────────────────────────────────────────────────────╮
   │ --model             TEXT     LLM Gateway model that translates the           │
-  │                              utterances.                                     │
+  │                              utterances                                      │
   │                              [default: claude-haiku-4-5-20251001]            │
-  │ --max-tokens        INTEGER  Max tokens per utterance translation.           │
+  │ --max-tokens        INTEGER  Max tokens per utterance translation            │
   │                              [default: 1000]                                 │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -371,7 +371,7 @@
   
    Usage: assembly eval [OPTIONS] DATASET
   
-   Transcribe an evaluation dataset and score WER against its reference texts.
+   Transcribe a dataset and score WER against its reference texts
   
    Each row's audio is transcribed, then scored against the row's reference
    text; both are normalized first (lowercased, punctuation stripped) so style
@@ -392,33 +392,33 @@
   
   ╭─ Arguments ──────────────────────────────────────────────────────────────────╮
   │ *    dataset      TEXT  Hugging Face dataset id, or a local .csv/.jsonl      │
-  │                         manifest with audio + text columns.                  │
+  │                         manifest with audio + text columns                   │
   │                         [required]                                           │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
   │ --split                  TEXT                      Hugging Face split to     │
-  │                                                    score (default: test).    │
+  │                                                    score (default: test)     │
   │ --subset                 TEXT                      Hugging Face              │
   │                                                    config/subset name (e.g.  │
-  │                                                    a language).              │
-  │ --limit                  INTEGER RANGE             Rows to evaluate (1-100). │
+  │                                                    a language)               │
+  │ --limit                  INTEGER RANGE             Rows to evaluate (1-100)  │
   │                          [1<=x<=100]               [default: 10]             │
   │ --audio-column           TEXT                      Audio column name         │
-  │                                                    (default: auto-detect).   │
+  │                                                    (default: auto-detect)    │
   │ --text-column            TEXT                      Reference text column     │
   │                                                    name (default:            │
-  │                                                    auto-detect).             │
-  │ --speech-model           [universal-3-pro|univers  Speech model to evaluate. │
+  │                                                    auto-detect)              │
+  │ --speech-model           [universal-3-pro|univers  Speech model to evaluate  │
   │                          al-2]                                               │
   │ --language-code          TEXT                      Force a language (e.g.    │
-  │                                                    en_us).                   │
+  │                                                    en_us)                    │
   │ --concurrency            INTEGER RANGE [x>=1]      How many items to         │
   │                                                    transcribe at once        │
-  │                                                    (sequential by default).  │
+  │                                                    (sequential by default)   │
   │                                                    [default: 1]              │
   │ --json           -j                                Output the rows and       │
   │                                                    summary as one JSON       │
-  │                                                    object.                   │
+  │                                                    object                    │
   │ --help                                             Show this message and     │
   │                                                    exit.                     │
   ╰──────────────────────────────────────────────────────────────────────────────╯
@@ -442,22 +442,22 @@
   
    Usage: assembly llm [OPTIONS] [PROMPT]
   
-   Send a prompt to AssemblyAI's LLM Gateway and print the response.
+   Send a prompt to AssemblyAI's LLM Gateway and print the reply
   
    With --transcript-id the transcript's text is injected server-side, so you
    can ask questions about a past transcription (e.g. assembly llm "summarize"
    --transcript-id ID).
   
   ╭─ Arguments ──────────────────────────────────────────────────────────────────╮
-  │   prompt      [PROMPT]  The prompt to send to the model.                     │
+  │   prompt      [PROMPT]  The prompt to send to the model                      │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --model                  TEXT                  LLM Gateway model.            │
+  │ --model                  TEXT                  LLM Gateway model             │
   │                                                [default:                     │
   │                                                claude-haiku-4-5-20251001]    │
   │ --transcript-id          TEXT                  Inject this transcript's text │
-  │                                                into the prompt.              │
-  │ --system                 TEXT                  Optional system prompt.       │
+  │                                                into the prompt               │
+  │ --system                 TEXT                  Optional system prompt        │
   │ --follow         -f                            Re-run the prompt over a      │
   │                                                growing transcript piped on   │
   │                                                stdin, refreshing the answer  │
@@ -469,8 +469,8 @@
   │ --output         -o      [text|json]           Print one field of the        │
   │                                                result: text (just the        │
   │                                                answer, pipe-friendly) or     │
-  │                                                json.                         │
-  │ --max-tokens             INTEGER RANGE [x>=1]  Max tokens to generate.       │
+  │                                                json                          │
+  │ --max-tokens             INTEGER RANGE [x>=1]  Max tokens to generate        │
   │                                                [default: 1000]               │
   │ --config                 TEXT                  Set any extra gateway request │
   │                                                field: KEY=VALUE, repeatable  │
@@ -478,9 +478,9 @@
   │                                                temperature=0.2). Values      │
   │                                                parse as JSON, else literal   │
   │                                                text.                         │
-  │ --list-models                                  Print known models and exit.  │
+  │ --list-models                                  Print known models and exit   │
   │ --json           -j                            Output raw JSON (one object   │
-  │                                                per turn in --follow mode).   │
+  │                                                per turn in --follow mode)    │
   │ --help                                         Show this message and exit.   │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -504,7 +504,7 @@
   
    Usage: assembly speak [OPTIONS] [TEXT]
   
-   [sandbox] Synthesize speech from text with AssemblyAI streaming TTS.
+   [sandbox] Synthesize speech from text with AssemblyAI streaming TTS
   
    Plays the audio through your speakers by default, or writes a WAV with
    --out. Speaker-labeled input (from 'assembly transcribe
@@ -521,7 +521,7 @@
   │                                              mary, paul, eve, george), or    │
   │                                              SPEAKER=VOICE for diarized      │
   │                                              input (repeatable, e.g. --voice │
-  │                                              A=jane).                        │
+  │                                              A=jane)                         │
   │ --language             TEXT                  Language of the text. The       │
   │                                              default voice follows it (e.g.  │
   │                                              --language Italian speaks with  │
@@ -531,9 +531,9 @@
   │                                              (positive). Server default if   │
   │                                              omitted.                        │
   │ --out                  PATH                  Write a WAV file instead of     │
-  │                                              playing through the speakers.   │
+  │                                              playing through the speakers    │
   │ --json         -j                            Emit JSON metadata about the    │
-  │                                              synthesized audio.              │
+  │                                              synthesized audio               │
   │ --help                                       Show this message and exit.     │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -558,7 +558,7 @@
   
    Usage: assembly stream [OPTIONS] [SOURCE]
   
-   Transcribe live audio in real time — from your mic, a file, a URL, or a pipe.
+   Transcribe live audio in real time from a mic, file, URL, or pipe
   
    Pass - as the source to read raw PCM16/mono/16k audio on stdin, e.g.
    ffmpeg -i input.mp4 -f s16le -ar 16000 -ac 1 - | assembly stream -.
@@ -573,12 +573,12 @@
   │                         to use the microphone.                               │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --sample                          Stream the hosted wildfires.mp3 sample.    │
-  │ --json       -j                   Emit newline-delimited JSON events.        │
+  │ --sample                          Stream the hosted wildfires.mp3 sample     │
+  │ --json       -j                   Emit newline-delimited JSON events         │
   │ --output     -o      [text|json]  Output mode: text (finalized turns as      │
-  │                                   plain lines, pipe-friendly) or json.       │
+  │                                   plain lines, pipe-friendly) or json        │
   │ --show-code                       Print the equivalent Python SDK code and   │
-  │                                   exit (does not stream).                    │
+  │                                   exit (does not stream)                     │
   │ --help                            Show this message and exit.                │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Audio Capture ──────────────────────────────────────────────────────────────╮
@@ -587,79 +587,79 @@
   │                                                  for the mic, or the         │
   │                                                  declared rate of raw PCM on │
   │                                                  stdin (default: device      │
-  │                                                  native / 16000).            │
-  │ --device                   INTEGER               Microphone device index.    │
+  │                                                  native / 16000)             │
+  │ --device                   INTEGER               Microphone device index     │
   │ --system-audio                                   macOS only: stream          │
   │                                                  system/app audio and        │
   │                                                  microphone as separate      │
-  │                                                  sessions.                   │
+  │                                                  sessions                    │
   │ --system-audio-only                              macOS only: stream          │
   │                                                  system/app audio without    │
-  │                                                  the microphone.             │
+  │                                                  the microphone              │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Model & Language ───────────────────────────────────────────────────────────╮
-  │ --speech-model              [universal-streaming-m  Streaming speech model.  │
+  │ --speech-model              [universal-streaming-m  Streaming speech model   │
   │                             ultilingual|universal-  [default: u3-rt-pro]     │
   │                             streaming-english|u3-r                           │
   │                             t-pro|whisper-rt|u3-pr                           │
   │                             o]                                               │
-  │ --encoding                  [pcm_s16le|pcm_mulaw]   Audio encoding.          │
+  │ --encoding                  [pcm_s16le|pcm_mulaw]   Audio encoding           │
   │ --language-detection                                Auto-detect the spoken   │
-  │                                                     language.                │
+  │                                                     language                 │
   │ --domain                    TEXT                    Domain preset (e.g.      │
-  │                                                     medical).                │
+  │                                                     medical)                 │
   │ --prompt                    TEXT                    Prompt to bias the       │
   │                                                     speech model (supported  │
-  │                                                     models only).            │
+  │                                                     models only)             │
   │ --keyterms-prompt           TEXT                    Boost a key term         │
-  │                                                     (repeatable).            │
+  │                                                     (repeatable)             │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Turn Detection ─────────────────────────────────────────────────────────────╮
   │ --end-of-turn-confidence                         FLOAT RANGE   End-of-turn   │
   │                                                  [0.0<=x<=1.0  confidence    │
-  │                                                  ]             (0-1).        │
+  │                                                  ]             (0-1)         │
   │ --min-turn-silence                               INTEGER       Min silence   │
   │                                                                to end a turn │
-  │                                                                (ms).         │
+  │                                                                (ms)          │
   │ --max-turn-silence                               INTEGER       Max silence   │
   │                                                                before ending │
-  │                                                                a turn (ms).  │
+  │                                                                a turn (ms)   │
   │ --vad-threshold                                  FLOAT RANGE   Voice         │
   │                                                  [0.0<=x<=1.0  activity      │
   │                                                  ]             threshold     │
-  │                                                                (0-1).        │
+  │                                                                (0-1)         │
   │ --format-turns              --no-format-turns                  Format        │
   │                                                                (punctuate)   │
   │                                                                finalized     │
-  │                                                                turns.        │
+  │                                                                turns         │
   │ --include-partial-turns                                        Emit partial  │
-  │                                                                turns.        │
+  │                                                                turns         │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Speakers & Channels ────────────────────────────────────────────────────────╮
   │ --speaker-labels                              Diarize speakers. With system  │
   │                                               audio the mic stays "You";     │
   │                                               only the system audio is split │
   │                                               into speakers.                 │
-  │ --max-speakers          INTEGER RANGE [x>=1]  Max speakers.                  │
+  │ --max-speakers          INTEGER RANGE [x>=1]  Max speakers                   │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Features ───────────────────────────────────────────────────────────────────╮
   │ --voice-focus                  [near-field|far-field  Voice focus (noise     │
-  │                                ]                      suppression model).    │
+  │                                ]                      suppression model)     │
   │ --voice-focus-threshold        FLOAT RANGE            Voice-focus threshold  │
-  │                                [0.0<=x<=1.0]          (0-1).                 │
+  │                                [0.0<=x<=1.0]          (0-1)                  │
   │ --inactivity-timeout           INTEGER                Auto-close after N     │
-  │                                                       seconds idle.          │
+  │                                                       seconds idle           │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Guardrails ─────────────────────────────────────────────────────────────────╮
-  │ --filter-profanity               Mask profanity.                             │
-  │ --redact-pii                     Redact PII from turns.                      │
-  │ --redact-pii-policy        TEXT  Comma-separated PII policies.               │
+  │ --filter-profanity               Mask profanity                              │
+  │ --redact-pii                     Redact PII from turns                       │
+  │ --redact-pii-policy        TEXT  Comma-separated PII policies                │
   │ --redact-pii-sub           TEXT  Replace redacted PII with: hash or          │
-  │                                  entity_name.                                │
+  │                                  entity_name                                 │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Webhooks ───────────────────────────────────────────────────────────────────╮
-  │ --webhook-url                TEXT        Webhook URL.                        │
-  │ --webhook-auth-header        NAME:VALUE  Webhook auth header as NAME:VALUE.  │
+  │ --webhook-url                TEXT        Webhook URL                         │
+  │ --webhook-auth-header        NAME:VALUE  Webhook auth header as NAME:VALUE   │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ LLM Transform ──────────────────────────────────────────────────────────────╮
   │ --llm                 TEXT                  Run a prompt over the live       │
@@ -670,17 +670,17 @@
   │                                             one's response (a chain).        │
   │ --llm-interval        FLOAT RANGE [x>=0.0]  Seconds between --llm summary    │
   │                                             refreshes (0 refreshes on every  │
-  │                                             turn).                           │
+  │                                             turn)                            │
   │                                             [default: 10.0]                  │
-  │ --model               TEXT                  LLM Gateway model.               │
+  │ --model               TEXT                  LLM Gateway model                │
   │                                             [default:                        │
   │                                             claude-haiku-4-5-20251001]       │
-  │ --max-tokens          INTEGER               Max tokens. [default: 1000]      │
+  │ --max-tokens          INTEGER               Max tokens [default: 1000]       │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Advanced ───────────────────────────────────────────────────────────────────╮
   │ --config             KEY=VALUE  Set any StreamingParameters field as         │
-  │                                 KEY=VALUE (repeatable).                      │
-  │ --config-file        FILE       JSON file of streaming fields.               │
+  │                                 KEY=VALUE (repeatable)                       │
+  │ --config-file        FILE       JSON file of streaming fields                │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
    Examples
@@ -708,7 +708,7 @@
   
    Usage: assembly t [OPTIONS] [SOURCE]
   
-   Transcribe an audio file, URL, or YouTube/podcast link — or a whole batch.
+   Transcribe a file, URL, or YouTube/podcast link — or a whole batch
   
    Quickest start: assembly transcribe call.mp3 (or --sample for the hosted
    demo).
@@ -732,11 +732,11 @@
   
   ╭─ Arguments ──────────────────────────────────────────────────────────────────╮
   │   source      [SOURCE]  Audio file, URL, YouTube/podcast URL, bucket URL     │
-  │                         (s3://, gs://, …), or a directory/glob (batch mode). │
+  │                         (s3://, gs://, …), or a directory/glob (batch mode)  │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
   │ --sample                                             Use the hosted          │
-  │                                                      wildfires.mp3 sample.   │
+  │                                                      wildfires.mp3 sample    │
   │ --json               -j                              Output the full result  │
   │                                                      as JSON. Text stays the │
   │                                                      default even when       │
@@ -745,18 +745,18 @@
   │ --output             -o      [text|id|status|uttera  Print one field: text,  │
   │                              nces|srt|vtt|json]      id, status, utterances, │
   │                                                      srt or vtt (captions),  │
-  │                                                      or json.                │
+  │                                                      or json                 │
   │ --chars-per-caption          INTEGER RANGE [x>=1]    Max characters per      │
   │                                                      caption line (only with │
-  │                                                      -o srt or -o vtt).      │
+  │                                                      -o srt or -o vtt)       │
   │ --out                        FILE                    Save the result to a    │
   │                                                      file instead of         │
   │                                                      printing it (clean      │
-  │                                                      text; pairs with -o).   │
+  │                                                      text; pairs with -o)    │
   │ --show-code                                          Print the equivalent    │
   │                                                      Python SDK code and     │
   │                                                      exit (does not          │
-  │                                                      transcribe).            │
+  │                                                      transcribe)             │
   │ --help                                               Show this message and   │
   │                                                      exit.                   │
   ╰──────────────────────────────────────────────────────────────────────────────╯
@@ -764,82 +764,82 @@
   │ --from-stdin                               Batch mode: read audio paths/URLs │
   │                                            from stdin, one per line          │
   │                                            (composes with find/ls/yt-dlp     │
-  │                                            output).                          │
+  │                                            output)                           │
   │ --concurrency        INTEGER RANGE [x>=1]  How many sources to transcribe at │
-  │                                            once in batch mode.               │
+  │                                            once in batch mode                │
   │                                            [default: 4]                      │
   │ --force                                    Batch mode: re-transcribe sources │
   │                                            whose sidecar already records a   │
-  │                                            completed run.                    │
+  │                                            completed run                     │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Model & Language ───────────────────────────────────────────────────────────╮
-  │ --speech-model              [best|nano|slam-1|univ  Speech model.            │
+  │ --speech-model              [best|nano|slam-1|univ  Speech model             │
   │                             ersal]                                           │
   │ --language-code             TEXT                    Force a language (e.g.   │
-  │                                                     en_us).                  │
+  │                                                     en_us)                   │
   │ --language-detection                                Auto-detect the spoken   │
-  │                                                     language.                │
+  │                                                     language                 │
   │ --keyterms-prompt           TEXT                    Boost a key term         │
-  │                                                     (repeatable).            │
+  │                                                     (repeatable)             │
   │ --temperature               FLOAT RANGE             Speech model temperature │
   │                             [0.0<=x<=1.0]           (0 most deterministic, 1 │
-  │                                                     least).                  │
+  │                                                     least)                   │
   │ --prompt                    TEXT                    Prompt to bias the       │
   │                                                     speech model (supported  │
-  │                                                     models only).            │
+  │                                                     models only)             │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Formatting ─────────────────────────────────────────────────────────────────╮
-  │ --punctuate       --no-punctuate        Add punctuation.                     │
+  │ --punctuate       --no-punctuate        Add punctuation                      │
   │ --format-text     --no-format-text      Apply text formatting (casing,       │
-  │                                         numbers).                            │
-  │ --disfluencies                          Keep filler words (e.g. um, uh).     │
+  │                                         numbers)                             │
+  │ --disfluencies                          Keep filler words (e.g. um, uh)      │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Speakers & Channels ────────────────────────────────────────────────────────╮
-  │ --speaker-labels                                 Enable diarization.         │
-  │ --speakers-expected        INTEGER RANGE [x>=1]  Hint speaker count.         │
+  │ --speaker-labels                                 Enable diarization          │
+  │ --speakers-expected        INTEGER RANGE [x>=1]  Hint speaker count          │
   │ --multichannel                                   Transcribe each audio       │
-  │                                                  channel separately.         │
+  │                                                  channel separately          │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Guardrails ─────────────────────────────────────────────────────────────────╮
   │ --redact-pii                                            Redact PII from the  │
-  │                                                         transcript.          │
+  │                                                         transcript           │
   │ --redact-pii-policy                TEXT                 Comma-separated PII  │
   │                                                         policies (e.g.       │
-  │                                                         person_name,...).    │
+  │                                                         person_name,...)     │
   │ --redact-pii-sub                   [hash|entity_name]   How to replace       │
-  │                                                         redacted PII.        │
-  │ --redact-pii-audio                                      Also redact audio.   │
-  │ --filter-profanity                                      Mask profanity.      │
+  │                                                         redacted PII         │
+  │ --redact-pii-audio                                      Also redact audio    │
+  │ --filter-profanity                                      Mask profanity       │
   │ --content-safety                                        Detect sensitive     │
-  │                                                         content.             │
+  │                                                         content              │
   │ --content-safety-confidence        INTEGER RANGE        Content-safety       │
   │                                    [25<=x<=100]         confidence threshold │
-  │                                                         (25-100).            │
+  │                                                         (25-100)             │
   │ --speech-threshold                 FLOAT RANGE          Minimum proportion   │
   │                                    [0.0<=x<=1.0]        of speech required   │
-  │                                                         (0-1).               │
+  │                                                         (0-1)                │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Analysis ───────────────────────────────────────────────────────────────────╮
   │ --summarization                                      Summarize the           │
-  │                                                      transcript.             │
-  │ --summary-model             [informative|conversati  Summary model.          │
+  │                                                      transcript              │
+  │ --summary-model             [informative|conversati  Summary model           │
   │                             onal|catchy]                                     │
-  │ --summary-type              [bullets|bullets_verbos  Summary format.         │
+  │ --summary-type              [bullets|bullets_verbos  Summary format          │
   │                             e|gist|headline|paragra                          │
   │                             ph]                                              │
-  │ --auto-chapters                                      Generate chapters.      │
-  │ --sentiment-analysis                                 Analyze sentiment.      │
-  │ --entity-detection                                   Detect entities.        │
-  │ --auto-highlights                                    Detect key phrases.     │
-  │ --topic-detection                                    Detect IAB topics.      │
+  │ --auto-chapters                                      Generate chapters       │
+  │ --sentiment-analysis                                 Analyze sentiment       │
+  │ --entity-detection                                   Detect entities         │
+  │ --auto-highlights                                    Detect key phrases      │
+  │ --topic-detection                                    Detect IAB topics       │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Customization ──────────────────────────────────────────────────────────────╮
   │ --word-boost                  TEXT                  Boost a word             │
-  │                                                     (repeatable).            │
+  │                                                     (repeatable)             │
   │ --custom-spelling-file        FILE                  JSON map of custom       │
-  │                                                     spellings.               │
-  │ --audio-start                 INTEGER RANGE [x>=0]  Start offset in ms.      │
-  │ --audio-end                   INTEGER RANGE [x>=0]  End offset in ms.        │
+  │                                                     spellings                │
+  │ --audio-start                 INTEGER RANGE [x>=0]  Start offset in ms       │
+  │ --audio-end                   INTEGER RANGE [x>=0]  End offset in ms         │
   │ --download-sections           TEXT                  For a YouTube/podcast    │
   │                                                     URL, download only part  │
   │                                                     of the source (yt-dlp    │
@@ -847,30 +847,30 @@
   │                                                     syntax, e.g.             │
   │                                                     "*0:00-5:00" for the     │
   │                                                     first five minutes;      │
-  │                                                     repeatable).             │
+  │                                                     repeatable)              │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Webhooks ───────────────────────────────────────────────────────────────────╮
   │ --webhook-url                TEXT        Webhook URL for completion (get a   │
   │                                          dev URL with `assembly webhooks     │
-  │                                          listen`).                           │
-  │ --webhook-auth-header        NAME:VALUE  Webhook auth header as NAME:VALUE.  │
+  │                                          listen`)                            │
+  │ --webhook-auth-header        NAME:VALUE  Webhook auth header as NAME:VALUE   │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Translation ────────────────────────────────────────────────────────────────╮
-  │ --translate-to        TEXT  Translate transcript to a language (repeatable). │
+  │ --translate-to        TEXT  Translate transcript to a language (repeatable)  │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Advanced ───────────────────────────────────────────────────────────────────╮
   │ --config             KEY=VALUE  Set any TranscriptionConfig field as         │
-  │                                 KEY=VALUE (repeatable).                      │
-  │ --config-file        FILE       JSON file of config fields.                  │
+  │                                 KEY=VALUE (repeatable)                       │
+  │ --config-file        FILE       JSON file of config fields                   │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ LLM Transform ──────────────────────────────────────────────────────────────╮
   │ --llm               TEXT     Transform the finished transcript through LLM   │
   │                              Gateway. Repeatable: each prompt runs on the    │
   │                              previous one's response (a chain), the first on │
   │                              the transcript.                                 │
-  │ --model             TEXT     LLM Gateway model.                              │
+  │ --model             TEXT     LLM Gateway model                               │
   │                              [default: claude-haiku-4-5-20251001]            │
-  │ --max-tokens        INTEGER  Max tokens. [default: 1000]                     │
+  │ --max-tokens        INTEGER  Max tokens [default: 1000]                      │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
    Examples
@@ -886,7 +886,7 @@
   
    Usage: assembly transcribe [OPTIONS] [SOURCE]
   
-   Transcribe an audio file, URL, or YouTube/podcast link — or a whole batch.
+   Transcribe a file, URL, or YouTube/podcast link — or a whole batch
   
    Quickest start: assembly transcribe call.mp3 (or --sample for the hosted
    demo).
@@ -910,11 +910,11 @@
   
   ╭─ Arguments ──────────────────────────────────────────────────────────────────╮
   │   source      [SOURCE]  Audio file, URL, YouTube/podcast URL, bucket URL     │
-  │                         (s3://, gs://, …), or a directory/glob (batch mode). │
+  │                         (s3://, gs://, …), or a directory/glob (batch mode)  │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
   │ --sample                                             Use the hosted          │
-  │                                                      wildfires.mp3 sample.   │
+  │                                                      wildfires.mp3 sample    │
   │ --json               -j                              Output the full result  │
   │                                                      as JSON. Text stays the │
   │                                                      default even when       │
@@ -923,18 +923,18 @@
   │ --output             -o      [text|id|status|uttera  Print one field: text,  │
   │                              nces|srt|vtt|json]      id, status, utterances, │
   │                                                      srt or vtt (captions),  │
-  │                                                      or json.                │
+  │                                                      or json                 │
   │ --chars-per-caption          INTEGER RANGE [x>=1]    Max characters per      │
   │                                                      caption line (only with │
-  │                                                      -o srt or -o vtt).      │
+  │                                                      -o srt or -o vtt)       │
   │ --out                        FILE                    Save the result to a    │
   │                                                      file instead of         │
   │                                                      printing it (clean      │
-  │                                                      text; pairs with -o).   │
+  │                                                      text; pairs with -o)    │
   │ --show-code                                          Print the equivalent    │
   │                                                      Python SDK code and     │
   │                                                      exit (does not          │
-  │                                                      transcribe).            │
+  │                                                      transcribe)             │
   │ --help                                               Show this message and   │
   │                                                      exit.                   │
   ╰──────────────────────────────────────────────────────────────────────────────╯
@@ -942,82 +942,82 @@
   │ --from-stdin                               Batch mode: read audio paths/URLs │
   │                                            from stdin, one per line          │
   │                                            (composes with find/ls/yt-dlp     │
-  │                                            output).                          │
+  │                                            output)                           │
   │ --concurrency        INTEGER RANGE [x>=1]  How many sources to transcribe at │
-  │                                            once in batch mode.               │
+  │                                            once in batch mode                │
   │                                            [default: 4]                      │
   │ --force                                    Batch mode: re-transcribe sources │
   │                                            whose sidecar already records a   │
-  │                                            completed run.                    │
+  │                                            completed run                     │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Model & Language ───────────────────────────────────────────────────────────╮
-  │ --speech-model              [best|nano|slam-1|univ  Speech model.            │
+  │ --speech-model              [best|nano|slam-1|univ  Speech model             │
   │                             ersal]                                           │
   │ --language-code             TEXT                    Force a language (e.g.   │
-  │                                                     en_us).                  │
+  │                                                     en_us)                   │
   │ --language-detection                                Auto-detect the spoken   │
-  │                                                     language.                │
+  │                                                     language                 │
   │ --keyterms-prompt           TEXT                    Boost a key term         │
-  │                                                     (repeatable).            │
+  │                                                     (repeatable)             │
   │ --temperature               FLOAT RANGE             Speech model temperature │
   │                             [0.0<=x<=1.0]           (0 most deterministic, 1 │
-  │                                                     least).                  │
+  │                                                     least)                   │
   │ --prompt                    TEXT                    Prompt to bias the       │
   │                                                     speech model (supported  │
-  │                                                     models only).            │
+  │                                                     models only)             │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Formatting ─────────────────────────────────────────────────────────────────╮
-  │ --punctuate       --no-punctuate        Add punctuation.                     │
+  │ --punctuate       --no-punctuate        Add punctuation                      │
   │ --format-text     --no-format-text      Apply text formatting (casing,       │
-  │                                         numbers).                            │
-  │ --disfluencies                          Keep filler words (e.g. um, uh).     │
+  │                                         numbers)                             │
+  │ --disfluencies                          Keep filler words (e.g. um, uh)      │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Speakers & Channels ────────────────────────────────────────────────────────╮
-  │ --speaker-labels                                 Enable diarization.         │
-  │ --speakers-expected        INTEGER RANGE [x>=1]  Hint speaker count.         │
+  │ --speaker-labels                                 Enable diarization          │
+  │ --speakers-expected        INTEGER RANGE [x>=1]  Hint speaker count          │
   │ --multichannel                                   Transcribe each audio       │
-  │                                                  channel separately.         │
+  │                                                  channel separately          │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Guardrails ─────────────────────────────────────────────────────────────────╮
   │ --redact-pii                                            Redact PII from the  │
-  │                                                         transcript.          │
+  │                                                         transcript           │
   │ --redact-pii-policy                TEXT                 Comma-separated PII  │
   │                                                         policies (e.g.       │
-  │                                                         person_name,...).    │
+  │                                                         person_name,...)     │
   │ --redact-pii-sub                   [hash|entity_name]   How to replace       │
-  │                                                         redacted PII.        │
-  │ --redact-pii-audio                                      Also redact audio.   │
-  │ --filter-profanity                                      Mask profanity.      │
+  │                                                         redacted PII         │
+  │ --redact-pii-audio                                      Also redact audio    │
+  │ --filter-profanity                                      Mask profanity       │
   │ --content-safety                                        Detect sensitive     │
-  │                                                         content.             │
+  │                                                         content              │
   │ --content-safety-confidence        INTEGER RANGE        Content-safety       │
   │                                    [25<=x<=100]         confidence threshold │
-  │                                                         (25-100).            │
+  │                                                         (25-100)             │
   │ --speech-threshold                 FLOAT RANGE          Minimum proportion   │
   │                                    [0.0<=x<=1.0]        of speech required   │
-  │                                                         (0-1).               │
+  │                                                         (0-1)                │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Analysis ───────────────────────────────────────────────────────────────────╮
   │ --summarization                                      Summarize the           │
-  │                                                      transcript.             │
-  │ --summary-model             [informative|conversati  Summary model.          │
+  │                                                      transcript              │
+  │ --summary-model             [informative|conversati  Summary model           │
   │                             onal|catchy]                                     │
-  │ --summary-type              [bullets|bullets_verbos  Summary format.         │
+  │ --summary-type              [bullets|bullets_verbos  Summary format          │
   │                             e|gist|headline|paragra                          │
   │                             ph]                                              │
-  │ --auto-chapters                                      Generate chapters.      │
-  │ --sentiment-analysis                                 Analyze sentiment.      │
-  │ --entity-detection                                   Detect entities.        │
-  │ --auto-highlights                                    Detect key phrases.     │
-  │ --topic-detection                                    Detect IAB topics.      │
+  │ --auto-chapters                                      Generate chapters       │
+  │ --sentiment-analysis                                 Analyze sentiment       │
+  │ --entity-detection                                   Detect entities         │
+  │ --auto-highlights                                    Detect key phrases      │
+  │ --topic-detection                                    Detect IAB topics       │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Customization ──────────────────────────────────────────────────────────────╮
   │ --word-boost                  TEXT                  Boost a word             │
-  │                                                     (repeatable).            │
+  │                                                     (repeatable)             │
   │ --custom-spelling-file        FILE                  JSON map of custom       │
-  │                                                     spellings.               │
-  │ --audio-start                 INTEGER RANGE [x>=0]  Start offset in ms.      │
-  │ --audio-end                   INTEGER RANGE [x>=0]  End offset in ms.        │
+  │                                                     spellings                │
+  │ --audio-start                 INTEGER RANGE [x>=0]  Start offset in ms       │
+  │ --audio-end                   INTEGER RANGE [x>=0]  End offset in ms         │
   │ --download-sections           TEXT                  For a YouTube/podcast    │
   │                                                     URL, download only part  │
   │                                                     of the source (yt-dlp    │
@@ -1025,30 +1025,30 @@
   │                                                     syntax, e.g.             │
   │                                                     "*0:00-5:00" for the     │
   │                                                     first five minutes;      │
-  │                                                     repeatable).             │
+  │                                                     repeatable)              │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Webhooks ───────────────────────────────────────────────────────────────────╮
   │ --webhook-url                TEXT        Webhook URL for completion (get a   │
   │                                          dev URL with `assembly webhooks     │
-  │                                          listen`).                           │
-  │ --webhook-auth-header        NAME:VALUE  Webhook auth header as NAME:VALUE.  │
+  │                                          listen`)                            │
+  │ --webhook-auth-header        NAME:VALUE  Webhook auth header as NAME:VALUE   │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Translation ────────────────────────────────────────────────────────────────╮
-  │ --translate-to        TEXT  Translate transcript to a language (repeatable). │
+  │ --translate-to        TEXT  Translate transcript to a language (repeatable)  │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Advanced ───────────────────────────────────────────────────────────────────╮
   │ --config             KEY=VALUE  Set any TranscriptionConfig field as         │
-  │                                 KEY=VALUE (repeatable).                      │
-  │ --config-file        FILE       JSON file of config fields.                  │
+  │                                 KEY=VALUE (repeatable)                       │
+  │ --config-file        FILE       JSON file of config fields                   │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ LLM Transform ──────────────────────────────────────────────────────────────╮
   │ --llm               TEXT     Transform the finished transcript through LLM   │
   │                              Gateway. Repeatable: each prompt runs on the    │
   │                              previous one's response (a chain), the first on │
   │                              the transcript.                                 │
-  │ --model             TEXT     LLM Gateway model.                              │
+  │ --model             TEXT     LLM Gateway model                               │
   │                              [default: claude-haiku-4-5-20251001]            │
-  │ --max-tokens        INTEGER  Max tokens. [default: 1000]                     │
+  │ --max-tokens        INTEGER  Max tokens [default: 1000]                      │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
    Examples
@@ -1086,7 +1086,7 @@
   
    Usage: assembly webhooks listen [OPTIONS]
   
-   Receive AssemblyAI webhooks on a public URL and watch them arrive.
+   Receive AssemblyAI webhooks on a public URL and watch them arrive
   
    Opens a cloudflared quick tunnel to a local listener and prints the public
    URL to pass as --webhook-url (or webhook_url in the API). Each delivery is
@@ -1101,16 +1101,16 @@
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
   │ --port                INTEGER               Local listener port (the first   │
-  │                                             free port from here).            │
+  │                                             free port from here)             │
   │                                             [default: 8989]                  │
   │ --forward-to          TEXT                  Re-POST each delivery to this    │
-  │                                             URL (e.g. your local app).       │
+  │                                             URL (e.g. your local app)        │
   │ --no-tunnel                                 Local-only: skip the cloudflared │
-  │                                             public URL.                      │
+  │                                             public URL                       │
   │ --max-events          INTEGER RANGE [x>=0]  Exit after this many deliveries  │
-  │                                             (0 = run until Ctrl-C).          │
+  │                                             (0 = run until Ctrl-C)           │
   │                                             [default: 0]                     │
-  │ --json        -j                            One NDJSON record per delivery.  │
+  │ --json        -j                            One NDJSON record per delivery   │
   │ --help                                      Show this message and exit.      │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
diff --git a/tests/__snapshots__/test_snapshots_help_tools.ambr b/tests/__snapshots__/test_snapshots_help_tools.ambr
index cef3d763..440b7a42 100644
--- a/tests/__snapshots__/test_snapshots_help_tools.ambr
+++ b/tests/__snapshots__/test_snapshots_help_tools.ambr
@@ -24,14 +24,14 @@
    Usage: assembly config get [OPTIONS]
    KEY:{active_profile|env|telemetry_enabled}
   
-   Print one setting's stored value (`env` reads the selected profile's).
+   Print one setting's stored value (`env` reads the selected profile's)
   
   ╭─ Arguments ──────────────────────────────────────────────────────────────────╮
-  │ *    key      KEY:{active_profile|env|teleme  Which setting to read.         │
+  │ *    key      KEY:{active_profile|env|teleme  Which setting to read          │
   │               try_enabled}                    [required]                     │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --json  -j        Output raw JSON.                                           │
+  │ --json  -j        Output raw JSON                                            │
   │ --help            Show this message and exit.                                │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -50,10 +50,10 @@
   
    Usage: assembly config list [OPTIONS]
   
-   Show every persisted setting and the stored profiles.
+   Show every persisted setting and the stored profiles
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --json  -j        Output raw JSON.                                           │
+  │ --json  -j        Output raw JSON                                            │
   │ --help            Show this message and exit.                                │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -72,10 +72,10 @@
   
    Usage: assembly config path [OPTIONS]
   
-   Print where config.toml lives.
+   Print where config.toml lives
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --json  -j        Output raw JSON.                                           │
+  │ --json  -j        Output raw JSON                                            │
   │ --help            Show this message and exit.                                │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -94,15 +94,15 @@
    KEY:{active_profile|env|telemetry_enabled}
                               VALUE
   
-   Change one setting (`env` writes to the selected profile).
+   Change one setting (`env` writes to the selected profile)
   
   ╭─ Arguments ──────────────────────────────────────────────────────────────────╮
-  │ *    key        KEY:{active_profile|env|tele  Which setting to change.       │
+  │ *    key        KEY:{active_profile|env|tele  Which setting to change        │
   │                 metry_enabled}                [required]                     │
-  │ *    value      TEXT                          The new value. [required]      │
+  │ *    value      TEXT                          The new value [required]       │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --json  -j        Output raw JSON.                                           │
+  │ --json  -j        Output raw JSON                                            │
   │ --help            Show this message and exit.                                │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -123,10 +123,10 @@
   
    Usage: assembly doctor [OPTIONS]
   
-   Check that your environment is ready to use AssemblyAI.
+   Check that your environment is ready for AssemblyAI
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --json  -j        Output raw JSON.                                           │
+  │ --json  -j        Output raw JSON                                            │
   │ --help            Show this message and exit.                                │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -145,7 +145,7 @@
   
    Usage: assembly setup install [OPTIONS]
   
-   Set up your coding agent for AssemblyAI (docs MCP server + skills).
+   Set up your coding agent for AssemblyAI (docs MCP + skills)
   
    Installs three things: the assemblyai-docs MCP server (live API docs, via
    `claude mcp add`), the AssemblyAI skill (via `npx skills add`), and the
@@ -158,8 +158,8 @@
   │                                        under. Presence is detected across    │
   │                                        all scopes.                           │
   │                                        [default: user]                       │
-  │ --force                                Reinstall even if already present.    │
-  │ --json   -j                            Output raw JSON.                      │
+  │ --force                                Reinstall even if already present     │
+  │ --json   -j                            Output raw JSON                       │
   │ --help                                 Show this message and exit.           │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -180,13 +180,13 @@
   
    Usage: assembly setup remove [OPTIONS]
   
-   Remove the AssemblyAI MCP server and skills from your coding agent.
+   Remove the AssemblyAI MCP and skills from your coding agent
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
   │ --scope          [user|project|local]  Only remove the MCP from this scope.  │
   │                                        Default: remove from whichever scope  │
   │                                        it exists in.                         │
-  │ --json   -j                            Output raw JSON.                      │
+  │ --json   -j                            Output raw JSON                       │
   │ --help                                 Show this message and exit.           │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -205,11 +205,10 @@
   
    Usage: assembly setup status [OPTIONS]
   
-   Show whether the AssemblyAI MCP server and skills are set up in your coding
-   agent.
+   Show whether the AssemblyAI MCP and skills are set up in your coding agent
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --json  -j        Output raw JSON.                                           │
+  │ --json  -j        Output raw JSON                                            │
   │ --help            Show this message and exit.                                │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -228,10 +227,10 @@
   
    Usage: assembly telemetry disable [OPTIONS]
   
-   Opt out of anonymous usage telemetry for this machine.
+   Opt out of anonymous usage telemetry for this machine
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --json  -j        Output raw JSON.                                           │
+  │ --json  -j        Output raw JSON                                            │
   │ --help            Show this message and exit.                                │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -248,10 +247,10 @@
   
    Usage: assembly telemetry enable [OPTIONS]
   
-   Re-enable anonymous usage telemetry for this machine.
+   Re-enable anonymous usage telemetry for this machine
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --json  -j        Output raw JSON.                                           │
+  │ --json  -j        Output raw JSON                                            │
   │ --help            Show this message and exit.                                │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -268,7 +267,7 @@
   
    Usage: assembly telemetry flush [OPTIONS] PAYLOAD
   
-   Deliver one serialized telemetry event to the intake (internal).
+   Deliver one serialized telemetry event to the intake (internal)
   
    This is the detached flusher `telemetry.dispatch` spawns so user commands
    never
@@ -277,7 +276,7 @@
    produces output.
   
   ╭─ Arguments ──────────────────────────────────────────────────────────────────╮
-  │ *    payload      TEXT  Serialized telemetry payload (internal). [required]  │
+  │ *    payload      TEXT  Serialized telemetry payload (internal) [required]   │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
   │ --help          Show this message and exit.                                  │
@@ -296,10 +295,10 @@
   
    Usage: assembly telemetry status [OPTIONS]
   
-   Show whether anonymous usage telemetry is active, and why.
+   Show whether anonymous usage telemetry is active, and why
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
-  │ --json  -j        Output raw JSON.                                           │
+  │ --json  -j        Output raw JSON                                            │
   │ --help            Show this message and exit.                                │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
@@ -318,12 +317,12 @@
   
    Usage: assembly update [OPTIONS]
   
-   Update the CLI to the latest release via your install method (brew/pipx/uv).
+   Update the CLI to the latest release (brew/pipx/uv)
   
   ╭─ Options ────────────────────────────────────────────────────────────────────╮
   │ --check            Report whether a newer release exists without installing  │
-  │                    it.                                                       │
-  │ --json   -j        Output raw JSON.                                          │
+  │                    it                                                        │
+  │ --json   -j        Output raw JSON                                           │
   │ --help             Show this message and exit.                               │
   ╰──────────────────────────────────────────────────────────────────────────────╯
   
diff --git a/tests/test_init_command.py b/tests/test_init_command.py
index d7d700e9..98f511fc 100644
--- a/tests/test_init_command.py
+++ b/tests/test_init_command.py
@@ -195,7 +195,7 @@ def test_init_template_arg_help_is_derived_from_registry():
     assert isinstance(default, ArgumentInfo)
     assert default.help == (
         "Template to scaffold: audio-transcription, live-captions, voice-agent "
-        "(omit to pick interactively)."
+        "(omit to pick interactively)"
     )
 
 
diff --git a/tests/test_sessions_command.py b/tests/test_sessions_command.py
index fd1c8bf6..842369cb 100644
--- a/tests/test_sessions_command.py
+++ b/tests/test_sessions_command.py
@@ -206,3 +206,11 @@ def test_sessions_without_session_runs_login(monkeypatch, mocker):
     assert config.get_session("default") == {"jwt": "jwt", "token": "tok"}
     list_.assert_not_called()
     assert "Run the same command again" in result.output
+
+
+def test_sessions_no_subcommand_shows_help():
+    # no_args_is_help=True: bare `assembly sessions` prints its help (the subcommand list)
+    # rather than the bare "Missing command." usage error that no_args_is_help=False emits.
+    result = runner.invoke(app, ["sessions"])
+    assert "Missing command" not in result.output
+    assert "list" in result.output and "get" in result.output
diff --git a/tests/test_setup.py b/tests/test_setup.py
index 4c160dc2..e48647c0 100644
--- a/tests/test_setup.py
+++ b/tests/test_setup.py
@@ -227,7 +227,7 @@ def test_setup_help_install_summary_is_a_complete_sentence():
     result = runner.invoke(app, ["setup", "--help"])
     # Strip ANSI (CI forces color) and unwrap lines before matching.
     flat = " ".join(re.sub(r"\x1b\[[0-9;]*m", "", result.output).split())
-    assert "Set up your coding agent for AssemblyAI (docs MCP server + skills)." in flat
+    assert "Set up your coding agent for AssemblyAI (docs MCP + skills)" in flat
     assert "three things:" not in flat
 
 
diff --git a/tests/test_transcripts.py b/tests/test_transcripts.py
index 8ad94439..30184387 100644
--- a/tests/test_transcripts.py
+++ b/tests/test_transcripts.py
@@ -268,3 +268,11 @@ def test_list_table_colors_status(monkeypatch, mocker):
     assert "error" in result.output
     assert "\x1b[1;32m" in result.output  # aai.success (bold green) → "completed" cell
     assert "\x1b[1;38;2;240;68;56m" in result.output  # aai.error (bold #F04438) → "error" cell
+
+
+def test_transcripts_no_subcommand_shows_help():
+    # no_args_is_help=True: bare `assembly transcripts` prints its help (the subcommand list)
+    # rather than the bare "Missing command." usage error that no_args_is_help=False emits.
+    result = runner.invoke(app, ["transcripts"])
+    assert "Missing command" not in result.output
+    assert "list" in result.output and "get" in result.output
diff --git a/tests/test_webhook_listen.py b/tests/test_webhook_listen.py
index b3395478..d7bb9ee8 100644
--- a/tests/test_webhook_listen.py
+++ b/tests/test_webhook_listen.py
@@ -355,3 +355,11 @@ def test_listen_missing_cloudflared_errors_before_binding(monkeypatch):
     assert result.exit_code == 1
     assert "cloudflared is required to expose a public webhook URL." in result.output
     assert "Install it:" in result.output
+
+
+def test_webhooks_no_subcommand_shows_help():
+    # no_args_is_help=True: bare `assembly webhooks` prints its help (the subcommand list)
+    # rather than the bare "Missing command." usage error that no_args_is_help=False emits.
+    result = runner.invoke(app, ["webhooks"])
+    assert "Missing command" not in result.output
+    assert "listen" in result.output