--- name: wuji-cli-user description: "Create, switch, list, show, rename, or delete wuji SDK user profiles, and export/import calibration bundles (hand model + tactile model) between machines, all via the `wuji user` CLI. These are named calibration profiles under ~/.wuji — NOT operating-system accounts — so use this skill (never edit code or touch OS users) for any request to delete a user, switch/change the current user, rename a user, create or list users, resolve the 'default user cannot calibrate' block, or move/inspect calibration data. Delete and import are destructive; the skill covers the safe, confirmation-first way to run them." compatibility: Requires Wuji CLI installed with the wuji executable available on PATH. Run `wuji update --skills` first so these skills match the installed CLI version. metadata: author: wuji-technology version: "2026.11.9" requires: bins: - wuji cliHelp: "wuji user --help" --- A **user profile** is a local record of one person's calibration data under `~/.wuji/sdk`. `wuji user` manages these profiles and moves calibration bundles between machines. Every subcommand is a local operation (registry + files, **no device connection**) and supports `--json`. ## Mental Model - A profile is keyed by its **name** — this is the only identifier the user sees (there is no OS account link; the SDK's internal id is not exposed). - Calibration is scoped per profile: the hand model is per **user + hand side**; tactile is per **device SN**. - The **default user cannot store a calibrated hand model**. `wuji calib hand-model` refuses to run until a named profile is active. Tactile calibration is device-specific and may be stored, inspected, exported, or imported while Default is active. - Stateless and local: no persistent connection, no device involved. ## Commands | Command | Purpose | | --- | --- | | `wuji user list` | List profiles; the current one is marked `*`, `Default` is `(hand model not calibratable)`, each row shows left/right hand model calibration state | | `wuji user show [name]` | Show a profile's description, hand model (state/file/size/time), and tactile (per SN) artifacts; defaults to the current profile | | `wuji user create [-d\|--description ] [--switch]` | Create a named profile with an optional description (does not switch unless `--switch`) | | `wuji user switch [name]` | Make a profile current; omitting the name in a Human TTY opens a profile selector | | `wuji user rename ` | Rename; calibration data follows | | `wuji user delete [name] [--yes]` | Delete a profile and all its calibration data; omitting the name in a Human TTY opens a profile selector | | `wuji user export [--force]` | Export the current profile's calibration bundle to a `.zip` | | `wuji user import [--preview] [-y\|--yes] [--as ]` | Import a bundle into the current (or a new) profile | Add `--help` to any subcommand for details. ## Safety (read before destructive actions) - **`delete` is irreversible** and removes all of a profile's calibration data. In a Human TTY, omitting the name opens a selector that excludes `Default`, marks the current profile, and defaults to `Cancel operation`; after selection, the CLI prints what will be removed, suggests `wuji user export` for a backup, and asks for a default-No confirmation. Do not select a profile on the user's behalf. Do **not** pass `--yes` unless the user has explicitly authorized deleting that specific profile; `--yes` requires the name to be present. `Default` cannot be deleted. - **`import` overwrites** the target profile's artifacts. Preview first with `--preview` (or read the interactive Cliclack preview) and relay the **source user, bundle version, contents, and any conflicts** before proceeding. In Human TTY mode, use the fixed-footer menus to choose whether to overwrite the current profile, create a new profile, or cancel; `--as ` selects the new-profile path up front. When the bundle comes from a different user and the target already has artifacts, the CLI backs them up under `calibration-import-backups/` before overwriting. - **A bundle containing a hand model cannot be imported into `Default`**: `Default` cannot hold hand model artifacts, so the CLI refuses (exit `5`) instead of succeeding with the model silently dropped. Import into a named profile with `--as `, or `wuji user create --switch` first. A tactile-only bundle still imports into `Default` normally. - **Import is not atomic.** If it fails partway, the profile can hold a mix of new and previous artifacts. The CLI says so, points at the backup directory when one was made, and tells the user to verify with `wuji user show `. Relay that recovery path — do not retry blindly. - **Non-interactive modes require explicit consent**: in `--json`/`--jsonl` or without a TTY, use `--preview` for a read-only import preview or `-y`/`--yes` to apply the import; `delete` requires both an explicit profile name and `--yes`. Only add a confirmation flag after confirming the user's intent — never as a default. - **`export` never clobbers silently**: in Human TTY mode, exporting over an existing file asks for confirmation and defaults to No; non-interactive or structured output still requires `--force`. This includes a **directory** target whose auto-generated name collides. Exporting a profile with **no calibration data** fails and tells the user to complete a calibration first — nothing is written. - **`Default` is protected**: it cannot be deleted or renamed. Deleting the current profile resets the current user to `Default` (the CLI reports this). - Never choose among multiple profiles on the user's behalf. In a Human TTY, `wuji user switch` without a name opens a selector that includes `Default`, marks the current profile, and defaults to `Cancel operation`; let the user choose. Outside a TTY, supply the explicitly requested profile name. When a profile name is not found, run `wuji user list`, relay the available profiles, and ask which one to use. ## Calibration Workflow First-time or default-user flow: ```bash wuji user create alice -d "Left-hand operator" --switch # named profile is now current wuji calib hand-model # calibration is allowed ``` If hand model calibration reports the default-user guidance (`create` / `switch` first), create and switch to a named profile, then retry. Tactile calibration does not require a named profile. Obtain confirmation before starting either calibration workflow (see the `wuji-cli-calib` skill). ## Exit Codes and JSON | Code | Meaning | | --- | --- | | 0 | Success (including a no-op switch to the current profile) | | 2 | Invalid user name | | 3 | User already exists | | 4 | User not found | | 5 | Default-user protection (delete/rename `Default`, or run hand model calibration as default) | | 6 | Bundle file not found | | 7 | Bundle invalid or incompatible version | | 8 | Export target already exists (use `--force`) | | 9 | Cancelled at confirmation | With `--json`/`--jsonl`, success prints one document per command; errors print `{"error":{"code":N,"message":...}}`. Branch on `code` (and the process exit code), not on parsing the message text. `create`, `switch`, `rename`, and `delete` all report `current_user` — the active profile after the action, whether or not this action changed it. Read it from the command's own output instead of following up with `list --json`; the field is always present, so no branching on "did this affect me" is needed. `rename` also reports `previous_name`, so a script can confirm which profile it just renamed. ## Examples ```bash wuji user list --json # Inspect profiles + calibration state wuji user create alice --description "Left-hand operator" --switch # Create and activate a profile wuji user show --json # Current profile's artifacts wuji user export ./alice.zip # Export current profile wuji user import ./alice.zip --preview # Inspect a bundle without importing wuji user import ./alice.zip # Preview, then confirm import wuji user import ./alice.zip --as bob # Import into a fresh profile ```