Getting Started

Prerequisites

Ubuntu 22.04 or later
Devices on the same local network (UDP) or connected via USB

Installation

Use the install script (recommended):

curl -fsSL https://get.wuji.tech/cli | bash

Alternatively, download the latest binary from Releases, then install it:

sudo cp wuji_<version>_<arch> /usr/local/bin/wuji

Verification

Run wuji devices and confirm your device shows up:

$ wuji devices
found 1 device(s)
┌──────────────────┬───────────┬──────────┬─────────────────────┬─────────────────────┐
│ SN               ┆ Transport ┆ USB Port ┆ IP                  ┆ Address             │
╞══════════════════╪═══════════╪══════════╪═════════════════════╪═════════════════════╡
│ WG1KXXXXXXXXXXX  ┆ Udp       ┆ -        ┆ 192.168.1.100:50001 ┆ 192.168.1.100:50001 │
└──────────────────┴───────────┴──────────┴─────────────────────┴─────────────────────┘
💡 run `wuji ping` to get device type and firmware version

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           # Download and install the latest release
wuji update --check   # Check for updates without installing

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:

mkdir -p ~/.local/share/bash-completion/completions
wuji completions bash > ~/.local/share/bash-completion/completions/wuji
exec bash   # takes effect in the current session

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:

npx skills add wuji-technology/wuji-cli

Alternatively, use the install script:

curl -fsSL https://get.wuji.tech/skills | bash

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.