devicesdk status | DeviceSDK

Usage

devicesdk status [flags]

Flags

--device <name> - Show status for a specific device only
--project <id> - Project ID (overrides config file)
--config <path> - Path to config file (default: devicesdk.ts)

Description

The status command shows the live connection status of all devices in your project. For each device it displays:

DEVICE - the device slug
STATUS - ● online, ○ offline, or ⚠ error (status fetch failed)
VERSION - the first 8 characters of the deployed script version ID
FIRMWARE - the firmware version reported by the device, with the device type in parentheses (e.g. 0.2.0 (pico-w)), or unknown when the firmware predates version reporting
LAST SEEN - how long ago the device last connected (or “never” if it has never connected)

Device status is read in real time from your server - there is no caching.

Examples

Show status of all devices in the current project:

devicesdk status

Show status for a specific device:

devicesdk status --device temperature-sensor

Show status for a project not in your config file:

devicesdk status --project my-project-id

Example Output

Project: my-project

  DEVICE               STATUS     VERSION   FIRMWARE        LAST SEEN
  ─────────────────────────────────────────────────────────────────────
  temperature-sensor   ● online   a1b2c3d4  0.2.0 (pico-w)  connected 2m ago
  humidity-sensor      ○ offline  a1b2c3d4  0.2.0 (pico-w)  5h ago
  door-sensor          ○ offline  -         unknown         never

Exit Codes

0 - success (even if all devices are offline)
1 - project not found, device not found, or authentication error