device fleet check

Overview

Connects to profiled devices over SSH, collects runtime versions (Docker, Python, Node.js, etc.) and system health metrics (CPU, memory, disk), then displays a color-coded summary. Use this for a quick at-a-glance view of fleet health without generating a full report.

Devices must have SSH configured in their profile.yaml under connectivity.ssh.

Usage

device fleet check [OPTIONS]

Options

Option	Description	Default
-d, --device SLUG	Check a single device by its profile slug	All devices
-p, --platform [linux|windows|macos]	Filter by platform	All platforms
--repo-root PATH	Repository root directory	Auto-detected

Prerequisites

• Repo: device-deployments
• SSH: Key-based SSH auth configured to target devices (BatchMode=yes, ConnectTimeout=5)
• Profiles: Devices must have connectivity.ssh block in their profile.yaml
• Versions: health/versions.json should be up to date for accurate staleness detection

Examples

Check all fleet devices

device fleet check

Check a single device

device fleet check -d homelab

Check only Linux devices

device fleet check -p linux

Check with explicit repo root

device fleet check --repo-root /path/to/device-deployments

Exit Codes

Code	Meaning
0	All devices healthy (or no devices found)
1	Some devices unreachable
2	All devices unreachable

Output

Rich-formatted panels showing per-device status:

• Green: Runtime versions are current
• Yellow: Minor/patch version behind
• Red: Major version behind or unreachable