@sky.ui/cli-ultra

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-ultra directly only when bundling or scripting against it.

Install

End users install @sky.ui.ultra/* packages only — not this CLI package. Use npx for one-off commands:

npx sky.ui.ultra login          # once per machine
npx sky.ui.ultra install        # or rely on your app's postinstall (see below)

Add a postinstall script in your app so hydration runs on every npm install without adding the CLI as a dependency:

{
  "scripts": {
    "postinstall": "npx --yes sky.ui.ultra install --yes"
  }
}

--yes on npx skips the “install package?” prompt; install --yes skips interactive stack selection.

Quick start

npx sky.ui.ultra login
npm install "@sky.ui.ultra/vue"
npm install   # postinstall hydrates licensed artifacts

Or run the interactive menu:

npx sky.ui.ultra

Commands

| Command | Description | |---------|-------------| | sky.ui.ultra login | Browser device login; saves personal token for Ultra installs | | sky.ui.ultra install | Install Ultra packages for your stack, then hydrate licensed artifacts | | sky.ui.ultra install --yes | Non-interactive install | | sky.ui.ultra install --dry-run | Preview install plan without writing | | 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 install --version=x.y.z | Pin the Ultra entry; peers follow via peerDependencies (not added as direct deps) | | sky.ui.ultra update | Alias for install --upgrade (latest or --version=) | | sky.ui.ultra uninstall | Remove paid Ultra packages from the project | | sky.ui.ultra uninstall --include-free | Also remove free @sky.ui/* peers | | sky.ui.ultra status | Account and license status | | sky.ui.ultra devices | List registered devices / seats | | sky.ui.ultra devices remove <id> --yes | Non-interactive device deactivation | | 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, npx sky.ui.ultra install (typically via your app's postinstall script) hydrates the full licensed package into node_modules.

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_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 Ultra 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.

Package-manager subprocesses do not receive SKY_UI_AUTH_TOKEN or SKY_UI_PERSONAL_TOKEN by default. Hydration keeps tokens inside the CLI; legacy private-registry passthrough requires explicitly setting SKY_UI_ALLOW_PACKAGE_MANAGER_TOKEN_ENV=1.

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 .ultra 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 | Ultra Lit components (stub until hydrated) | | @sky.ui.ultra/vue | Ultra Vue wrappers (stub until hydrated) | | @sky.ui.ultra/react | Ultra React wrappers (stub until hydrated) |

License

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