motionsites CLI

Publish-ready local CLI for pulling MotionSites AI-ready design resources.

The package name is motionsites, but it does not need to be published while iterating locally.

Commands

motionsites help
motionsites version
motionsites doctor
motionsites list [--type skill|section|background|prompt] [--tag <tag>] [--json]
motionsites search <query> [--type skill|section|background|prompt] [--json]
motionsites show <slug> [--json]
motionsites pull <slug> [--target raw|claude|cursor|markdown] [--output <path>] [--dry-run] [--force]

Global options:

--registry <url-or-path>
--json
--help / -h
--version / -v

Environment variable:

MOTIONSITES_REGISTRY=https://motionsites.ai/registry.json

Local usage

From the repository root:

node packages/cli/bin/motionsites.mjs --help
node packages/cli/bin/motionsites.mjs version
node packages/cli/bin/motionsites.mjs doctor --registry http://localhost:3000/registry.json
node packages/cli/bin/motionsites.mjs list --registry http://localhost:3000/registry.json
node packages/cli/bin/motionsites.mjs search aurora --registry http://localhost:3000/registry.json
node packages/cli/bin/motionsites.mjs show aurora-hero --registry http://localhost:3000/registry.json
node packages/cli/bin/motionsites.mjs pull aurora-hero --registry http://localhost:3000/registry.json --dry-run

Pull targets

node packages/cli/bin/motionsites.mjs pull aurora-hero --target raw
node packages/cli/bin/motionsites.mjs pull aurora-hero --target claude
node packages/cli/bin/motionsites.mjs pull aurora-hero --target cursor
node packages/cli/bin/motionsites.mjs pull aurora-hero --target markdown

• raw writes a multi-file package to .motionsites/<slug>/.
• claude writes a Claude skill package to .claude/skills/<slug>/.
• cursor writes one Cursor rule file to .cursor/rules/motionsites-<slug>.md.
• markdown writes one portable Markdown file.

Use --output <path> to override the default output path, --dry-run to preview writes, and --force to overwrite existing files.

Future npm usage

After the motionsites package is published to npm, the intended command is:

npx motionsites list
npx motionsites pull aurora-hero
npx motionsites pull premium-ai-saas-motion --target claude

Publishing is not required for local iteration.