@archetypeai/ds-cli

CLI for the Archetype AI Design System. Scaffold new projects, add the design system to existing ones, and manage components and agent configurations.

Run directly with npx:

npx @archetypeai/ds-cli create my-app

Commands

create → Scaffold a new project

npx @archetypeai/ds-cli create my-app

Sets up a SvelteKit + Tailwind v4 + shadcn-svelte project with design tokens, components, and an optional demo page.

| Flag | Values | Default | |------|--------|---------| | --framework | svelte | prompt | | --pm | npm, pnpm, bun, yarn | prompt | | --fonts <path> | path to PP Neue Montreal fonts folder | prompt | | --no-fonts | skip font installation (use system fallback) | — | | --no-components | skip component install | install all | | --codeagent | cursor, claude, none | prompt | | --defaults | force non-interactive mode | — |

npx @archetypeai/ds-cli create my-app --pm pnpm --no-fonts --codeagent claude
npx @archetypeai/ds-cli create my-app --pm npm --fonts /path/to/fonts --codeagent claude

Non-interactive mode (no TTY or --defaults): all required flags must be specified. The CLI lists missing options and exits so agents can ask the user before proceeding.

init → Add DS to an existing project

cd my-existing-app
npx @archetypeai/ds-cli init

Run from a SvelteKit project root. Auto-detects your package manager, installs tokens, shadcn-svelte, and components, and prepends DS imports to your layout.css (preserving existing styles).

| Flag | Values | Default | |------|--------|---------| | --pm | npm, pnpm, bun, yarn | auto-detect | | --fonts <path> | path to PP Neue Montreal fonts folder | prompt | | --no-fonts | skip font installation (use system fallback) | — | | --no-components | skip component install | install all | | --codeagent | cursor, claude, none | prompt | | --defaults | force non-interactive mode | — |

npx @archetypeai/ds-cli init --pm npm --no-fonts --codeagent claude
npx @archetypeai/ds-cli init --pm npm --fonts /path/to/fonts --codeagent claude

add → Add components, tokens, or agent config

add ds-ui-svelte

npx @archetypeai/ds-cli add ds-ui-svelte

Installs design tokens, all components from the registry, and optionally local fonts. Requires shadcn-svelte (components.json must exist).

| Flag | Values | Default | |------|--------|---------| | --fonts <path> | path to PP Neue Montreal fonts folder | prompt | | --no-fonts | skip font installation (use system fallback) | — |

npx @archetypeai/ds-cli add ds-ui-svelte --fonts /path/to/fonts
npx @archetypeai/ds-cli add ds-ui-svelte --no-fonts

add ds-lib-tokens

npx @archetypeai/ds-cli add ds-lib-tokens

Installs @archetypeai/ds-lib-tokens and optionally local fonts.

| Flag | Values | Default | |------|--------|---------| | --fonts <path> | path to PP Neue Montreal fonts folder | prompt | | --no-fonts | skip font installation (use system fallback) | — |

npx @archetypeai/ds-cli add ds-lib-tokens --fonts /path/to/fonts
npx @archetypeai/ds-cli add ds-lib-tokens --no-fonts

Non-interactive mode (no TTY or --defaults): font flags must be specified. The CLI lists missing options and exits so agents can ask the user before proceeding.

add ds-config-codeagent

npx @archetypeai/ds-cli add ds-config-codeagent --cursor
npx @archetypeai/ds-cli add ds-config-codeagent --claude

| Flag | Effect | |------|--------| | --cursor | Installs AGENTS.md, skills, and rules to .cursor/ | | --claude | Installs CLAUDE.md, skills, and rules to .claude/ |

Without a flag, an interactive prompt asks which IDE to configure.