Complete command reference
CLI 1.2 commands, primary options, results and references for each workflow.
Requires WU CLI 1.2.0 and WU Framework 4.0.0 for application APIs. Check wu --version and the project dependencies.
wu --version
wu --helpEach command interprets its arguments; read its chapter for options and limits. The npm launcher selects the binary and manages wu update. Compilation commands and contract tools use project Node dependencies when needed.
| Command | Contract and reference |
|---|---|
wu create [name] --template <framework> --shell <framework> |
Create a project; without flags, start the wizard. |
wu add <framework> <name> [--no-install] |
Add an app. |
wu install [--force] |
Install dependencies; alias wu i. |
wu dev [--port <n>] [--native|--vite] [--open|--no-open] |
Development on one HTTP origin. |
wu build [--native] [--no-pwa] [--budget-warn] [--jobs <n>] [--no-cache] [--sign <key.pem>] |
Build production into dist/. |
wu serve [port] [--mode static|spa] |
Preview production; default port 3000. |
wu doctor [--json] [--url <url>] [--entry <path>] [--route <path>] [--timeout <ms>] [--integrity] [--pubkey <file>] |
Diagnose a project or deployed site. |
wu test [--browser] [options] |
Node or browser tests. |
wu mock <contract.json> [options] |
Generate an editable mock app. |
wu contracts types <files...> --out <file.d.ts> |
Generate types for one or multiple versions. |
wu contracts check <old.json> <new.json> [--translators <module>] [--json] |
Compare contracts and translator coverage. |
wu pack <app> [--sign <key.pem>] [--out <file.wuapp>] [--version <version>] [--dist <dir>] [--json] |
Package an app; wu pack --keygen <key.pem> generates a key. |
wu upgrade [--dry-run] [--check] [--yes] [--json] [--force] |
Migrate manifests and templates without downgrading. |
wu catalog [--json] |
Inspect the catalog of the installed CLI. |
wu info |
Show effective configuration. |
wu update |
Update the launcher and binary; project dependencies remain unchanged. |
wu version / wu --version / wu -v |
Show the compiled version. |
wu help / wu --help / wu -h |
Show general help; running wu without arguments does the same. |
deploy, status, config, remove, init and preview are not CLI commands. Publish dist/ using your hosting provider. Configure the project in wu.config.json. Unknown commands fail; test, contract and doctor exit codes are described in their chapters.