designdotmd

A CLI — for humans and agents — that adds design.md files from the designdotmd.directory registry into your project.

Browse, preview, and search every available design at https://designdotmd.directory, then pull the one you want straight into your repo with this CLI.

Install

npm install -g designdotmd

Or run it on demand without installing:

npx designdotmd <command>

Usage

Running designdotmd with no command prints a warning and the help menu. Every command is discoverable through --help / -h — agents should start there:

designdotmd --help
designdotmd -h

Commands

add <id>

Download a design.md into the current directory.

designdotmd add <id> [--out <path>] [--force]

| Flag | Default | Description | | --- | --- | --- | | -o, --out <path> | design.md | Where to write the file. | | -f, --force | false | Overwrite the output file if it already exists. |

list

List every available design.md in the registry.

designdotmd list

category [name]

Without an argument, lists every category in the registry. With a <name> argument, lists every design in that category.

designdotmd category
designdotmd category <name>

Global options

| Flag | Description | | --- | --- | | -V, --version | Print the CLI version. | | -h, --help | Show help for the CLI or any subcommand. |

For agents

This CLI is intentionally agent-first. To discover the full command surface programmatically, run:

designdotmd --help
designdotmd <command> --help

Typical agent flow:

1. designdotmd category — discover categories.
2. designdotmd category <name> or designdotmd list — pick an id.
3. designdotmd add <id> — drop the file into the project.

Links

• Directory, previews, and search: https://designdotmd.directory