wuji-technology/wuji-cli

wuji-cli-user

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.

Ver código-fonte

Como usar

  1. Copie o comando e verifique o pacote antes de instalar no seu ambiente de agente.
  2. Consulte no original as ferramentas, credenciais e ambientes necessários.
  3. Descreva os dados de entrada e a entrega esperada; confira a saída com as fontes.
npx skills add https://github.com/wuji-technology/wuji-cli --skill wuji-cli-user

Antes de começar

  • A instalação não inclui assinatura de modelo, franquia API ou acesso aos seus arquivos.
  • Estrelas e instalações indicam atividade, não um teste independente de qualidade ou segurança.
Documento original do Skill

Renderizado do repositório de origem, preservando títulos, exemplos, código, tabelas, links e imagens.

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

CommandPurpose
wuji user listList 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 <name> [-d\--description <text>] [--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 <old> <new>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 <path> [--force]Export the current profile's calibration bundle to a .zip
`wuji user import <path> [--preview] [-y\--yes] [--as <name>]`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 <name> 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 <name>, or wuji user create <name> --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 <name>. 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

CodeMeaning
0Success (including a no-op switch to the current profile)
2Invalid user name
3User already exists
4User not found
5Default-user protection (delete/rename Default, or run hand model calibration as default)
6Bundle file not found
7Bundle invalid or incompatible version
8Export target already exists (use --force)
9Cancelled 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
do mesmo repositório

Mais Skills

Todos os Skills
wuji-technology
Comunidade

wuji-cli-base

Interact with Wuji devices (data gloves / dexterous hands) via the wuji CLI: scan for devices (devices), probe connectivity with a handshake (ping), read and write device parameters (get/set), and subscribe to real-time data such as EMF, tactile, and IMU (sub). Use when you need to check device status, read sensor data, change device configuration, or write device automation scripts. For live Wuji Hand 2 visualization, see wuji-cli-viz. For device health diagnostics, see wuji-cli-doctor. For fir

Instalações / 1h
1
GitHub Stars
5
Atualizado
10 de nov.
wuji-technology
Comunidade

wuji-cli-calib

Guide safe Wuji Glove calibration with the wuji CLI. Use when the user asks to run or monitor wuji calib hand-model or wuji calib tactile, interpret calibration progress or errors, cancel an active calibration, inspect the resulting hand model, or choose between hand model and tactile calibration. Route each mode without applying the hand model's user-and-hand rules to tactile's device-specific model.

Instalações / 1h
1
GitHub Stars
5
Atualizado
10 de nov.
wuji-technology
Comunidade

wuji-cli-upgrade

Upgrade Wuji device firmware with wuji upgrade: check which devices have updates (--check), upgrade one or all devices to the latest release, install a specific version (--to), flash a local firmware package (--file), browse the firmware catalog (--list), and roll the device back to its backup firmware (rollback). Use when the user wants to upgrade, downgrade, roll back, or re-flash device firmware, or asks whether firmware updates are available.

Instalações / 1h
1
GitHub Stars
5
Atualizado
10 de nov.
wuji-technology
Comunidade

wuji-cli-viz

Visualize live Wuji Hand 2 or Wuji Glove data with the official Rerun Web Viewer using wuji viz. Use when a user wants to inspect hand pose, per-taxel forces, per-finger resultant force, force history, live visualization faults, interactive device selection, or Hand 2 runtime tactile zeroing.

Instalações / 1h
1
GitHub Stars
5
Atualizado
10 de nov.