list

List all brands in the catalog.

Synopsis

design-md list

Display all 300+ brands in the design.md catalog with their slugs, names, and tags. Featured designs are marked with a yellow star.

Behavior

The command fetches the catalog and prints a table of all available brands. Each row shows:

  • Star — Yellow ★ if the design is featured, blank otherwise
  • Slug — The brand identifier used with add and other commands
  • Name — The brand’s full name
  • Tags — Up to 4 category tags (dimmed)

The last line prints the total catalog size.

Examples

List all brands

design-md list

Output:

★ stripe              Stripe                    #payments #api #fintech
  linear              Linear                    #productivity #saas
  notion              Notion                    #workspace #collaboration
  anthropic           Anthropic                 #ai #research
  openai              OpenAI                    #ai #generative
★ vercel              Vercel                    #devtools #deployment
  apple               Apple                     #consumer #ecosystem
  airbnb              Airbnb                    #travel #marketplace
  plaid               Plaid                     #fintech #api
  grafana             Grafana                   #monitoring #observability
  ...
286 designs

Pipe to grep to find a specific brand

design-md list | grep postgres

Output:

  postgres            PostgreSQL                #database #sql

Count brands in a category with jq

design-md list | grep fintech | wc -l

Shows how many designs are tagged with “fintech”.

design-md list | grep '★'

Lists only the marked (featured) designs in the catalog.

Output

Text output is human-readable and terminal-friendly:

  • Columns are right-padded to align vertically
  • Colored output uses cyan for slugs, yellow for stars, and dimmed text for tags
  • Perfect for piping to grep, awk, or other Unix tools

Last line is dimmed and shows the total count of designs in the catalog.

  • category — Filter brands by category name
  • add — Pull a brand’s DESIGN.md into your repo
  • CLI overview — All 12 commands at a glance