Skip to content

Refactor README into Supabase/Vercel CLI house style#20

Merged
alexkroman merged 1 commit into
mainfrom
docs/readme-cli-house-style
Jun 5, 2026
Merged

Refactor README into Supabase/Vercel CLI house style#20
alexkroman merged 1 commit into
mainfrom
docs/readme-cli-house-style

Conversation

@alexkroman

Copy link
Copy Markdown
Collaborator

What

Refactors README.md to match the house style of the Supabase and Vercel CLI READMEs.

  • Centered header block — title, punchy tagline (Transcribe. Stream. Converse.), nav links, badges, and a --- divider.
  • Title Case task sections, each opening with one imperative sentence + a focused code block: Installation, Quick Start, Scaffold A Starter App, Transcribe A File, Stream Live Audio, Live Transcript → Live LLM, Voice Agent, Show The Code, Pipelines, API Key & Security, Account Self-Service, AI Coding Agents.
  • Reference / Development / License closers in the Supabase shape.
  • Compresses the prose (446 → ~310 lines) while keeping the distinctive content: keyring security model, pipeline composability, and --show-code.

markdownlint

Disables MD033 (inline HTML) and MD041 (first-line H1) in .markdownlint.json. The centered header is the house style and requires inline HTML; the Supabase and Vercel CLI repos disable these same rules. markdownlint README.md passes (exit 0).

Notes

  • No PyPI version badge — the assemblyai-cli PyPI name is squatted and the package isn't published there.
  • Badge brand color is a placeholder red (D6402E); swap in AssemblyAI's exact brand hex if preferred.

🤖 Generated with Claude Code

Restructure the README around a centered header (title, tagline, nav
links, badges) and Title Case task sections that each open with one
imperative sentence plus a code block. Compress the prose while keeping
the distinctive content (keyring security model, pipelines, --show-code).

Disable MD033 (inline HTML) and MD041 (first-line H1) in markdownlint so
the centered header passes the check.sh gate, matching how the Supabase
and Vercel CLI repos configure their linters.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@alexkroman alexkroman merged commit 00269e6 into main Jun 5, 2026
13 checks passed
@alexkroman alexkroman deleted the docs/readme-cli-house-style branch June 5, 2026 21:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants