device fleet report

Overview

Runs health checks on all SSH-configured fleet devices, then generates a self-contained HTML report with version staleness indicators and resource usage. The report uses inline CSS (no external dependencies) and auto-opens in the default browser.

Usage

device fleet report [OPTIONS]

Options

Option	Description	Default
-o, --output PATH	Output file path	reports/fleet-health-YYYY-MM-DD.html
--no-open	Don't auto-open report in browser	false
-d, --device SLUG	Check a single device by 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
• Profiles: Devices must have connectivity.ssh block in their profile.yaml

Examples

Generate report for all devices

device fleet report

Save to a specific path without opening

device fleet report -o /tmp/fleet-status.html --no-open

Report for a single device

device fleet report -d homelab

Output

A self-contained HTML file with:

• Per-device version table (Docker, Python, Node.js, etc.)
• Color-coded staleness indicators (current, minor behind, major behind)
• System resource usage (CPU, memory, disk)
• Timestamp and device connectivity status