CLI Reference

Complete reference for the TokenUI command-line interface. Install and manage design skills directly from your terminal.

Installation

No installation required. Use npx to run the CLI directly. If you prefer, you can install it globally for faster execution.

Recommended

npx tokenui.sh <command>

Global Install (optional)

npm install -g tokenui

Commands

add

Add a skill to your project. Installs the skill and all its dependencies.

npx tokenui.sh add <skill-name>

Example:

npx tokenui.sh add button

Options:

--path, -pCustom installation path

--force, -fOverwrite existing files

--dry-runPreview changes without applying

list

List all available skills in the gallery. Filter by category or search term.

npx tokenui.sh list

Example:

npx tokenui.sh list --category forms

Options:

--category, -cFilter by category

--search, -sSearch by keyword

--limit, -lLimit results (default: 20)

info

Show detailed information about a specific skill.

npx tokenui.sh info <skill-name>

Example:

npx tokenui.sh info modal

remove

Remove a skill from your project.

npx tokenui.sh remove <skill-name>

Example:

npx tokenui.sh remove button

Options:

--force, -fSkip confirmation prompt

update

Update skills to their latest versions.

npx tokenui.sh update

Example:

npx tokenui.sh update button

Options:

--all, -aUpdate all skills

publish

Publish a skill to the TokenUI gallery. Opens the publish page in your browser.

npx tokenui.sh publish

Options:

--draftSave as draft instead of publishing

init

Initialize a new TokenUI-compatible project. Sets up the directory structure and configuration.

npx tokenui.sh init

Example:

npx tokenui.sh init my-app

Options:

--template, -tUse a starter template

--yes, -ySkip prompts with defaults

Global Options

These options work with any command:

--help, -hShow help for a command

--version, -vShow CLI version

--verboseEnable verbose logging

--silentSuppress all output except errors

Configuration

Create a tokenui.json file in your project root to customize behavior:

tokenui.json

{
  "path": "./src/components",
  "typescript": true,
  "tailwind": true,
  "aliases": {
    "components": "@/components",
    "utils": "@/lib/utils"
  }
}

Configuration Options

pathDefault installation directory for skills

typescriptUse TypeScript by default

tailwindEnable Tailwind CSS integration

aliasesImport path aliases for your project

Common Workflows

Add multiple skills at once

npx tokenui.sh add button card modal input

Search and add skills interactively

npx tokenui.sh list --search form | npx tokenui.sh add

Update all skills in your project

npx tokenui.sh update --all

Install to a custom directory

npx tokenui.sh add button --path ./app/ui