> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wuji.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Started

> Install and update Wuji CLI, verify device connection, and set up shell completions

## Prerequisites

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

## Installation

Use the install script (recommended):

```bash theme={null}
curl -fsSL https://get.wuji.tech/cli | bash
```

Alternatively, download the latest binary from [Releases](https://github.com/wuji-technology/wuji-cli/releases), then install it:

```bash theme={null}
sudo cp wuji_<version>_<arch> /usr/local/bin/wuji
```

## Verification

Run `wuji devices` and confirm your device shows up:

```bash theme={null}
$ 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

```bash theme={null}
wuji update           # Download and install the latest release
wuji update --check   # Check for updates without installing
wuji update --skills  # Sync Wuji CLI skills only, without updating the binary
```

`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:

```bash theme={null}
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:

```bash theme={null}
npx --yes skills add wuji-technology/wuji-cli -g
```

Alternatively, use the install script:

```bash theme={null}
curl -fsSL https://get.wuji.tech/skills | bash
```

Skills available after installation:

| Skill | Purpose |
| - | - |
| `wuji-cli-base` | Scan devices, ping connectivity, read and write parameters, and subscribe to live data |
| `wuji-cli-calib` | Guide Wuji Glove hand model calibration and tactile calibration |
| `wuji-cli-doctor` | Run device health self-checks for EMF disconnects and tactile sensor dead pixels |
| `wuji-cli-logs` | Export, inspect, and locate device logs, and build support bundles |
| `wuji-cli-support` | Guide troubleshooting and produce a support report to send to [support@wuji.tech](mailto:support@wuji.tech) |
| `wuji-cli-upgrade` | Check for firmware updates, then upgrade, downgrade, or flash a specific package |
| `wuji-cli-user` | Manage SDK user profiles and export or import calibration bundles |
| `wuji-cli-viz` | Visualize live hand pose and tactile data in the Rerun Web Viewer |

<Warning>
  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.
</Warning>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.