wuji-cli-logs

Mental Model

• Logs are local text files written by Wuji SDK, Studio, stderr capture, and the CLI itself, stored under ~/.wuji/logs/. The CLI discovers and processes these files, and writes its own operation records as cli_*.jsonl.
• Text sources: sdk_*.log, studio_*.log, stderr_*.log, and cli_<date>.jsonl — the CLI's own record of the commands it runs (command line, exit code, duration, error). wuji sub and wuji completions write no operation records. Device communication dumps (device_*.bin) are excluded by default and gated behind --with-dump. wuji logs export bundles sdk, studio, stderr, and cli by default; pass --source to narrow the set. A wuji doctor run also records its report in the operation log, so a default bundle carries the checkup results. The operation log is redacted on export like every other text log; the local file itself stays as written, so it can be read directly while diagnosing.
• Export produces a single ZIP containing the selected log files, a host snapshot (host_snapshot.json), doctor diagnosis results (doctor_diagnosis.json — the same envelope as wuji doctor --json, with host-environment checks and per-device results all under checks), device snapshots + flash history (devices/<sn>_<ts>_device.json / _flash.jsonl, when devices are found), matching hand model calibration recordings, and a manifest (manifest.json). The snapshot and diagnosis are included even when no log files are found.
• Calibration recordings are automatic: runs from ~/.wuji/calibration/recordings/ that intersect the same inclusive local-date range are copied under calibration-recordings/<run_id>/. Partial or legacy runs with no ended_at are filtered as a single point at their local started_at date.
• Recording manifest compatibility: new hand-model runs use schema_version: 2 and calibration_type: "hand_model"; export also accepts legacy schema 1 / "ik" runs and preserves every source manifest unchanged.
• Redaction is layered: credentials (JWT, Bearer Token, API Key, Token, License, Password, AWS Key) are always redacted; private data (username, user paths, hostname, SSID, IPv4, MAC) is redacted by default and can be disabled via --no-redact (internal builds only). Calibration .mcap files contain raw motion data and are never redacted.
• Exit codes: 0 = success; 1 = any failure, including device diagnosis, log export, calibration recording, or device snapshot/flash collection failures. Recoverable items remain listed in the bundle manifest.

Subcommands