Skip to main content

Run Your First Extraction

CLI QuickstartBy Dembrandt2 min

In under 2 minutes you will turn any public website into a complete set of design tokens: colors, typography, spacing, borders, and more. All you need is Node.js and a terminal.

Dembrandt AppNew

Load extractions, pin a baseline, and track token drift over time. Compare snapshots and copy tokens directly into your workflow.

1.Prerequisites

You need two things before running Dembrandt.

  • Node.js — a free runtime that lets your computer run CLI tools like Dembrandt. Download it here (click the big green button, install like any app). If you've used npm before, you already have it.
  • A terminal — just a text window where you type commands.
    Mac: ⌘ Space → type Terminal → EnterWindows: ⊞ Win → type cmd → Enter

2.Install

Open your terminal, paste the line below, and press Enter. You only need to do this once.

Terminal
npm i -g dembrandt

Takes about 30 seconds. You'll see some text scroll by — that's normal.

3.Run it

Pick any public website — a competitor, a brand you admire, or your own. Pass its address as the argument:

Terminal
dembrandt example.com

Dembrandt opens the site in a headless browser, reads every computed style, and prints the full design system in your terminal. Usually takes 10–30 seconds.

dembrandt.comexample.com

4.Output

The terminal prints a structured design system — colors, typography, spacing, borders, and shadows:

~ terminal
$ dembrandt dembrandt.com
✓ Extracted design system from dembrandt.com
✓ Colors: 12 found
#133174#38BDF8#EA580C#FFFFFF#0A0A0F#8294A1
✓ Typography: 8 styles
• Heading: 48px / 36px / 24px
• Body: 16px / 14px / 12px
✓ Spacing: 12 tokens
4px • 8px • 12px • 16px • 24px • 32px • 48px...
✓ Shadows: 5 found
• 0 4px 8px rgba(0,0,0,0.1)
• 0 12px 24px rgba(0,0,0,0.15)
✓ Border radius: 4 values
4px • 8px • 12px • 16px

5.Flags

Add any of these to the end of your command:

--save-outputSave results as a JSON file on your computer
--brand-guideGenerate a brand guide PDF from any URL in 10 seconds
--design-mdExport a DESIGN.md file summarizing the extracted design system
--crawl 5Auto-discover and extract up to 5 pages via DOM links, merging into one output
--sitemapDiscover pages from sitemap.xml instead of DOM links
--dark-modeExtract the dark-mode design tokens (if the site has them)
--mobileExtract from a mobile viewport
--browser firefoxUse Firefox instead — helps with Cloudflare-protected sites
--dtcgExport tokens in W3C Design Tokens format
--wcagAnalyze WCAG contrast ratios between palette colors
--slowMore reliable extraction for JavaScript-heavy SPAs
--screenshot path/to/file.pngSave a screenshot of the page during extraction
--no-sandboxDisable browser sandbox — needed for Docker or CI environments
--key dmb_···Push the snapshot to your Dembrandt account. Each run is stored with a timestamp and automatically scored against the previous snapshot for that domain. Generate a key at dembrandt.com/app/api-keys.

6.AI Agent Integration (MCP)

Use Dembrandt as a tool inside Claude Code, Cursor, Windsurf, or any MCP-compatible editor. Your agent calls it automatically when you ask.

Terminal
claude mcp add --transport stdio dembrandt -- npx -y --package dembrandt dembrandt-mcp

Or add to your project's .mcp.json:

{
"mcpServers": {
"dembrandt": {
"command": "npx",
"args": ["-y", "--package", "dembrandt", "dembrandt-mcp"]
}
}
}

Tools available:

get_design_tokensget_color_paletteget_typographyget_component_stylesget_surfacesget_spacingget_brand_identityget_job_statuscancel_job
Full MCP documentation

7.Automatic drift tracking

Wire the CLI into CI and every deploy records a snapshot to your account automatically. Generate an API key in the App, then pass it with --key. Each run uploads its snapshot and scores it against the previous one for that domain — the history builds itself.

Terminal
dembrandt app.example.com --key dmb_··· --no-sandbox
See the full CI setup recipe

Questions? Open a GitHub Discussion.