Skip to main content

Palette CLI Reference

All Palette CLI commands are available under the shift-cli palette namespace. Commands accept either a nanoid(8) ID or a human-readable name wherever an identifier is required.

Global Flags​

FlagDescription
--jsonOutput structured JSON (for agent consumption)
--quietSuppress stdout, exit codes only

Tokens​

List tokens​

shift-cli palette tokens list
shift-cli palette tokens list --category color
shift-cli palette tokens list --group brand

Add a token​

shift-cli palette tokens add --name "primary-blue" --category color --value "#0066FF"

With dark mode value:

shift-cli palette tokens add --name "primary-blue" --category color --value "#0066FF" --dark "#3399FF"

Show a token​

shift-cli palette tokens show primary-blue
shift-cli palette tokens show a1b2c3d4

Remove a token​

shift-cli palette tokens rm primary-blue

Components​

List components​

shift-cli palette components list
shift-cli palette components list --status stable

Add a component​

shift-cli palette components add --name "Button" --status stable

Show a component​

shift-cli palette components show Button

Add a prop​

shift-cli palette components prop-add Button --name "variant" --type "string" --required

Add a variant​

shift-cli palette components variant-add Button --name "primary"

Add an example​

shift-cli palette components example-add Button --title "Default" --code "<Button variant=\"primary\">Click</Button>"

Remove a component​

shift-cli palette components rm Button

Patterns​

List patterns​

shift-cli palette patterns list

Add a pattern​

shift-cli palette patterns add --name "Form Validation" --category forms

Show a pattern​

shift-cli palette patterns show "Form Validation"

Add a step​

shift-cli palette patterns step-add "Form Validation" --order 1 --title "Validate on blur"

Remove a pattern​

shift-cli palette patterns rm "Form Validation"

Standards​

List standards​

shift-cli palette standards list

Add a standard​

shift-cli palette standards add --name "Logo Usage" --category logo

Remove a standard​

shift-cli palette standards rm "Logo Usage"

Accessibility Rules​

List a11y rules​

shift-cli palette a11y list
shift-cli palette a11y list --severity must

Add a rule​

shift-cli palette a11y add --name "Button labels" --category aria --severity must

Remove a rule​

shift-cli palette a11y rm "Button labels"

Export​

# Export as CSS custom properties
shift-cli palette export --format css

# Export as JSON theme object
shift-cli palette export --format json

# Export as Tailwind config
shift-cli palette export --format tailwind
shift-cli palette search "button"
shift-cli palette search "primary" --json

JSON output:

[
  {
    "kind": "token",
    "id": "a1b2c3d4",
    "name": "primary-blue",
    "description": "Primary brand color",
    "score": 10.5
  }
]