@sky.ui/cli

Command-line tools for Sky UI Ultra licensing — device login, guided install, license status, and optional npm setup.

This package powers sky.ui.ultra (npx sky.ui.ultra). Most users should run commands through npx; install @sky.ui/cli directly only when bundling or scripting against it.

Install

npm install -g sky.ui.ultra
# or
npm install @sky.ui/cli

Quick start

npx sky.ui.ultra login
npx sky.ui.ultra install

Or run the interactive menu:

npx sky.ui.ultra

Commands

| Command | Description | |---------|-------------| | sky.ui.ultra login | Browser device login; saves personal token for Pro installs | | sky.ui.ultra install | Install Pro packages for your stack, then hydrate licensed artifacts | | sky.ui.ultra install --yes | Non-interactive install | | sky.ui.ultra install --verbose | Show full package manager output and hydration logs | | sky.ui.ultra install --framework=vue | Force stack (vue, react, or core) | | sky.ui.ultra status | Account and license status | | sky.ui.ultra setup-npm | Print optional legacy .npmrc snippet | | sky.ui.ultra logout | Clear local session |

After npm install of @sky.ui.ultra/* stubs, sky.ui.ultra install hydrates the full licensed package into node_modules (replacing the stub manifest while keeping the public package name).

Credentials are stored in ~/.sky.ui/credentials.json.

Environment

Copy packages/ultra/npm/env.example to your app root as .env.

| Variable | Description | |----------|-------------| | SKY_UI_API_URL | API host (default production; local: http://127.0.0.1:3001) | | SKY_UI_AUTH_TOKEN | CI/CD token (sk_ci_…) | | SKY_UI_PERSONAL_TOKEN | Personal token (sk_pt_…) | | SKY_UI_PROJECT_ROOT | Optional explicit project root when cwd is ambiguous | | SKY_UI_ULTRA_FRAMEWORK | CI/non-TTY: core, vue, or react when auto-detect is ambiguous | | SKY_UI_ULTRA_LENIENT | CLI hydration: warn-only when token missing (default is strict) | | SKY_UI_ULTRA_LICENSE_LENIENT | Build plugins: warn-only on production build | | SKY_UI_ULTRA_SKIP_HYDRATE | Skip Pro package hydration entirely | | SKY_UI_ULTRA_SKIP_POSTINSTALL | Alias for SKY_UI_ULTRA_SKIP_HYDRATE | | SKY_UI_ULTRA_STRICT | Legacy alias; install is strict by default unless SKY_UI_ULTRA_LENIENT=1 |

The CLI reads SKY_UI_* from .env / .env.local using the same resolver as bundler plugins (INIT_CWD, npm prefix, SKY_UI_PROJECT_ROOT, cwd walk). Shell variables are never overwritten.

PowerShell

Quote scoped package names if you run npm yourself — npm install "@sky.ui.ultra/core". Unquoted @ is PowerShell splatting.

npx sky.ui.ultra login works on Windows (the npm package is sky.ui.ultra; the executable shim is sky-ui-ultra so Windows does not treat .pro as a file extension). After a global install, use sky-ui-ultra login or keep using npx sky.ui.ultra login.

See powershell-scoped-packages.md.

Stack detection

| package.json | Behavior | |----------------|----------| | vue or @sky.ui/vue only | Installs Vue stack | | react or @sky.ui/react only | Installs React stack | | Neither | Prompts (Core / Vue / React) in interactive terminal | | Both Vue and React | Prompts to pick one stack |

Non-interactive (--yes, CI): use --framework=… or SKY_UI_ULTRA_FRAMEWORK when ambiguous; otherwise defaults to Core with a notice.

Related packages

| Package | Role | |---------|------| | sky.ui.ultra | npx entry point (recommended) | | @sky.ui.ultra/core | Pro Lit components (stub until hydrated) | | @sky.ui.ultra/vue | Pro Vue wrappers (stub until hydrated) | | @sky.ui.ultra/react | Pro React wrappers (stub until hydrated) |

License

Sky UI Ultra Commercial License — proprietary. The CLI is free to run for login and install; Pro components it hydrates require an active subscription.