Package Exports
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@archetypeai/ds-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
@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-appCommands
create → Scaffold a new project
npx @archetypeai/ds-cli create my-appSets 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 claudeNon-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 initRun 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 claudeadd → Add components, tokens, or agent config
add ds-ui-svelte
npx @archetypeai/ds-cli add ds-ui-svelteInstalls 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-fontsadd ds-lib-tokens
npx @archetypeai/ds-cli add ds-lib-tokensInstalls @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-fontsNon-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.