wuji upgrade fetches firmware from the official catalog, flashes it over the connected transport, and prints a per-device report. The device reboots into the new firmware automatically.

Mental Model: Scope × Action

Every invocation is a scope (which devices) combined with an action (what to do). Running wuji upgrade with no arguments prints help — flashing never happens implicitly.

Scope (defaults to the only connected device):

--all — every discovered device (latest firmware only)
--type <TYPE> — every device of one type (matches ping's Device Type, case-insensitive, e.g. --type wuji_glove)
--sn / --address / --handedness — one device, same selectors as other commands

Actions:

--check — update overview, read-only, works with any scope
(no action flag) — upgrade the scoped devices to their latest catalog version
--to <VERSION> — install a specific catalog version
--file <PATH> — flash a local firmware file
--list — browse the firmware catalog, read-only

wuji-cli-upgrade

Mental Model: Scope × Action