SuperAPI AI Directory

wuji-cli-record

General & other

View repository

Updated 10-16 06:12

About this skill

Mental Model

wuji record teleop is a foreground, read-only observer. Start the existing Glove to Hand 2 teleoperation program first, then run recording in a second terminal. The recorder attaches to the owner's shared device sessions and never publishes commands or takes over a disconnected device.

The managed MCAP contains the fixed teleoperation preset: Glove emf_poses and hand_skeleton, global tf and tf_static, Hand 2 joint_command and joint_states, plus joint_diagnostics when available.

Record Teleoperation

# Unique active Glove + Hand 2 pair
wuji record teleop

# Select an explicit pair when multiple devices are active
wuji record teleop --glove <GLOVE_SN> --hand <HAND_SN>

Stop recording with Ctrl+C, or send exactly one SIGTERM with kill <PID>; then wait for the final stopped report. Do not send another Ctrl+C or SIGTERM, cancel the command, or kill the process while the MCAP is finalizing. A second signal during finalization forces an exit with code 130 and may leave an unfinalized partial recording. The CLI normally finalizes MCAP, updates the manifest, detaches both read-only sessions, and leaves the teleoperation owner running. kill -9 cannot be handled and may leave an interrupted, unfinalized file.

Human TTY terminals receive a compact heartbeat at 5 Hz. Non-TTY Human output appends one every 30 seconds. --json emits only the final report; --jsonl emits started, periodic progress, and final stopped records.

History and Export

wuji record list
wuji record list --days 7
wuji record list --json

wuji logs export --recording <RUN_ID> -o support.zip

Runs are stored under ~/.wuji/recordings/<RUN_ID>/ as manifest.json and recording.mcap. logs export includes recordings only when explicitly selected with repeatable --recording; date filtering never adds them automatically.

Safety and Privacy

  • MCAP and its manifest contain raw motion/control data and are not redacted.
  • The files remain local until the user explicitly exports or shares them.
  • Telemetry does not upload MCAP. Recording duration is reported only after a successful recording stop.
  • A healthy recording is complete when the user presses Ctrl+C or when teleoperation itself ends. Human output includes status, duration, size, output path, and next-step commands for reviewing or exporting recordings; structured output retains additional fields.

Common Errors

Error Action
no active teleoperation session found Start teleoperation and confirm both devices are visible with wuji devices.
multiple ... devices found Pass both --glove <SN> and --hand <SN>.
failed to attach Ensure the teleoperation owner enables device sharing. Do not close it to let the recorder take ownership.
Required channel unavailable Check that the owner, device firmware, SDK user profile, and hand model match the teleoperation setup.
Recording is partial Read the warning lines after the four-line summary. If recording.complete is true, the finalized MCAP remains available; if it is false, treat the file as potentially unfinalized and do not assume it is readable.