Prerequisites
- Ubuntu 22.04 LTS or later
- Devices on the same local network (UDP) or connected via USB
Installation
Use the install script (recommended):
Alternatively, download the latest binary from Releases, then install it:
Verification
Run wuji devices and confirm your device shows up:
If the list is empty, check that the device is powered on and on the same network segment as your host.
Update the CLI
wuji update --check shows the current version, the latest version, and the skills status. When an update is available, the output includes the release notes of the latest version.
wuji update installs the latest release and syncs the installed skills. A machine that skipped skills during CLI installation can install them with wuji update --skills.
wuji update --skills syncs skills to the current CLI version.
The CLI also checks for new releases in the background, at most once every 24 hours, and shows a notice when an update is available. The check never blocks or slows down your commands. Set WUJI_NO_UPDATE_CHECK=1 to turn the notice off.
Set up Shell Completions (Optional)
Once set up, press Tab while typing a wuji command to auto-complete subcommands and flags — no need to remember exact spellings. For bash:
For zsh, fish, powershell, or elvish, substitute the shell name in the command above. See wuji completions --help for details.
Install AI Skills (Optional)
Install Wuji CLI skills for AI coding assistants such as Claude Code, so an AI Agent can operate devices directly:
Alternatively, use the install script:
Skills available after installation:
An AI Agent can read and write parameters and control devices directly. Confirm what the agent does before it runs, especially writes, firmware upgrades, and other actions that change device state, so a misstep doesn’t damage your hardware.
