Getting Started / CLI
Developer CLI
Add Nodus DS components to any project with a single command. No config files, no wrappers — source files are copied directly into your project, styled with your existing Tailwind setup.
Quick demo
Three commands, zero config
Command reference
All commands
Every command supports --dry to preview what would happen without writing files.
$ npx nodus-ds add AgentCardCopy a component into your project. No install required — source files are copied directly.
Flags
Global options
| Flag | Command | Description |
|---|---|---|
| --dry, -d | all | Preview what would happen without writing any files |
| --list, -l | add | List all available components by category |
| --dir <path> | add | Override destination directory for copied component |
| --format <css|ts> | tokens | Token output format: CSS variables or TypeScript const |
| --out <file> | tokens | Custom output file path for token export |
| --version, -v | global | Show CLI version |
Architecture
How it works
Component paths are read from public/registry.json, generated at build time from registry-extended.ts. No runtime lookups.
The component .tsx file is copied into your project. You own it — no npm package to update, no black-box imports.
Components import via CSS custom properties (var(--ds-*)). Token files are the only npm dependency.
Once copied, the file is yours. Fork it, extend it, delete it. The CLI only scaffolds — it doesn't own your code.
Development
Run the CLI locally
When working inside the nodus-ds repo, use npm run cli instead of npx nodus-ds to skip the build step.
Related