wendy device info

Shows agent version, OS, architecture, GPU, and hardware info for the target device.

Usage

wendy device info [flags]

Description

wendy device info queries the connected device's agent and prints its version, operating system, CPU architecture, CPU core count, total RAM, GPU presence, and other hardware details. Use this command anywhere device metadata is needed — in scripts, CI pipelines, or interactively.

The output format follows the standard --json / human-readable convention shared across all device commands.

CPU and memory output

Two headline hardware specs are included when the agent reports them. Both are omitted from the human-readable output and the JSON map when the agent cannot read them (older agents or non-Linux hosts), so treat them as optional.

For live CPU and memory utilization, use wendy device top.

GPU output fields

On GPU-capable devices, the following GPU fields are included. Each is omitted from both the human-readable output and the JSON map when the agent does not report it (e.g. non-GPU devices or older agents), so consumers should treat every field as optional.

wendy device info reports static GPU metadata (vendor, architecture, toolkit versions). For live GPU utilization, memory, temperature, and power draw, use wendy device top.

Network output

The output includes the device's network interfaces and their routable IP addresses under a Network: block (human-readable) or a networkInterfaces array (JSON). This is the address to use to reach an app running on the device — the .local hostname does not always resolve on every network.

Loopback, down, and container/virtual bridge interfaces are omitted, as are link-local addresses. The section is absent entirely when the agent cannot enumerate interfaces (e.g. older agents).

OS Update output

On WendyOS devices that use the wendyos-update OTA engine, wendy device info prints a compact OS Update: block showing the live A/B slot state and the last recorded update outcome:

OS Update:
  Slot A: booted, rootfs normal, WendyOS 0.17.0
  Slot B: inactive, retries 2 (trial boot pending)
  Pending: wendyos-jetson 0.18.0 (installed, target slot B)
  Last update: committed (0.16.0 → 0.17.0)

The block is omitted entirely when:

• the device does not use the wendyos-update engine,
• the agent is too old to support the engine-status probe, or
• no update record exists and the live probe returns nothing.

When the last update outcome is not committed, a hint is printed:

  Details: wendy os update-status

Slot health is colour-coded: normal is green, anything else is red. Outcome words follow the same scheme: committed is green, rolled back is amber, and failure outcomes are red.

JSON: osUpdate field

When OS-update information is available, --json includes an osUpdate object. It is omitted entirely when nothing is reportable.

{
  "osUpdate": {
    "lastUpdate": {
      "outcome": "committed",
      "createdAtUnix": 1750000000,
      "oldOsVersion": "0.16.0",
      "newOsVersion": "0.17.0"
    },
    "engine": {
      "connector": "tegrauefi",
      "currentSlot": "A",
      "slots": [
        { "slot": "A", "booted": true, "partition": "/dev/nvme0n1p1", "distro": "WendyOS 0.17.0", "kernel": "5.15.148-tegra", "rootfsHealth": "normal", "retries": "", "note": "" },
        { "slot": "B", "booted": false, "partition": "/dev/nvme0n1p2", "retries": "2", "note": "trial boot pending" }
      ],
      "system": [
        { "key": "bootloader", "value": "36.3.0" }
      ],
      "pending": {
        "artifactName": "wendyos-jetson",
        "artifactVersion": "0.18.0",
        "phase": "installed",
        "targetSlot": "B"
      }
    }
  }
}

Flags

Examples

Print device info in human-readable form:

wendy device info --device my-device.local

Print device info as JSON (useful in scripts):

wendy device info --device my-device.local --json

Extract specific fields with jq:

wendy device info --device my-device.local --json | jq '{osVersion, agentVersion: .version, deviceType, cpuCount, memTotalBytes}'

Deprecated alias

wendy device version is a deprecated alias for this command. It remains functional for backward compatibility but is hidden from help output. When invoked in non-JSON mode it prints a deprecation warning to stderr:

Warning: 'wendy device version' is deprecated; use 'wendy device info' instead.

No warning is emitted when --json is passed, so existing machine-readable scripts that use wendy device version --json continue to work without noise on stderr.

Migrate any usage of wendy device version to wendy device info.

Related

• wendy os update-status — full OS update record including service-level healthcheck details and the live engine snapshot
• wendy os update — apply a WendyOS OTA update