Installation

Install the CLI, the MCP server, and verify both.

CLI — one-shot via npx (recommended)

Run the CLI on demand without installing:

npx @webdesignhot/design-md add stripe

That’s the most common case. The npx wrapper fetches the latest version each time, no global state. If you want it cached, install globally:

npm pnpm yarn bun

npm install -g @webdesignhot/design-md

pnpm add -g @webdesignhot/design-md

yarn global add @webdesignhot/design-md

bun add -g @webdesignhot/design-md

Verify:

design-md --version
# 0.5.0

MCP server — for AI agent loops

Install separately. Different package, same catalog backend:

npm install -g @webdesignhot/design-md-mcp

Then add an MCP config entry pointing at the binary. Config snippets by client below.

Claude Code

Add to ~/.config/claude-code/mcp.json (or via Settings → MCP):

{
  "mcpServers": {
    "design-md": {
      "command": "design-md-mcp",
      "args": []
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "design-md": {
      "command": "design-md-mcp",
      "args": []
    }
  }
}

Codex

Add to ~/.codex/config.toml:

[mcp_servers.design-md]
command = "design-md-mcp"
args = []

Cline

Add via Cline’s MCP Servers UI. Server name: design-md, command: design-md-mcp, no args.

Restart your editor after adding the config. The 6 tools (list_designs, get_design, search_designs, diff_designs, export_design, install_design) appear in the agent’s tool list. See Client Setup for verification steps.

Verify both

design-md --version       # should print 0.5.0 or later
design-md-mcp --version   # should print 0.1.2 or later

Once both pass, you’re done.