Repo: symphonycore-org/device-deployments
CLI entry point: device (installed via pip install -e .)
Framework: Click 8.1+
Language: Python
The device CLI manages the full device lifecycle: hardware auditing, app deployment, fleet health monitoring, and asset tracking via Snipe-IT.
Global Options
| Option | Description |
|---|
-v, --verbose | Enable verbose output |
--dry-run | Preview changes without executing |
-o, --output-format [table|json] | Output format |
Command Groups
audit -- Hardware discovery and profile generation
| Command | Description | Docs |
|---|
device audit collect | Collect hardware/software specs (local or SSH) | View |
device audit profile | Generate profile.yaml from specs | View |
fleet -- Fleet health monitoring
| Command | Description | Docs |
|---|
device fleet check | Check fleet device health via SSH | View |
device fleet report | Generate HTML health report | View |
snipeit -- Snipe-IT asset management
| Command | Description | Docs |
|---|
device snipeit status | Check connection and asset summary | View |
device snipeit search | Search assets by name, serial, tag | -- |
device snipeit update | Update asset fields from profile | -- |
device snipeit sync | Sync profile data to Snipe-IT | -- |
device snipeit sync-docs | Sync doc links to custom fields | -- |
windows -- Windows app management (winget)
| Command | Description | Docs |
|---|
device windows deploy | Deploy apps from manifest | View |
device windows audit | Audit compliance against manifest | -- |
device windows update | Update outdated packages | -- |
device windows list | List installed packages | -- |
device windows search | Search winget packages | -- |
device windows export | Export installed packages to manifest | -- |
macos -- macOS app management (Homebrew)
| Command | Description | Docs |
|---|
device macos deploy | Deploy apps from Brewfile | View |
device macos audit | Audit compliance against Brewfile | -- |
device macos update | Update outdated packages | -- |
android -- Android device management (ADB)
| Command | Description | Docs |
|---|
device android deploy | Deploy apps from manifest | View |
device android audit | Audit compliance against manifest | -- |
device android list | List connected devices | -- |
device android mirror | Start screen mirroring (scrcpy) | -- |
device android cellular | Check cellular hardware | -- |
linux -- Linux remote collection
| Command | Description | Docs |
|---|
device linux collect | Collect specs via SSH | View |
device linux profile | Generate profile from collected specs | -- |
ios -- iOS device inspection (read-only)
| Command | Description | Docs |
|---|
device ios inspect | Show connected device info | -- |
device ios apps | List installed applications | -- |
device ios report | Generate Apple ID migration report | -- |
health -- macOS system health monitoring
| Command | Description | Docs |
|---|
device health check | One-time health check | -- |
device health monitor | Continuous monitoring (foreground) | -- |
device health service install | Install launchd service | -- |
device health service uninstall | Uninstall launchd service | -- |
device health service status | Check service status | -- |
setup -- Environment setup
| Command | Description | Docs |
|---|
device setup vscode | Install VS Code extensions | View |
device setup git | Configure Git aliases | -- |
device setup profile | Apply machine profile config | -- |
device setup list-profiles | List available profiles | -- |
config -- Device override management
| Command | Description | Docs |
|---|
device config list | List device overrides | -- |
device config show | Show override details | -- |
device config validate | Validate override file | -- |
network -- Network discovery
| Command | Description | Docs |
|---|
device network discover | Discover devices on network | -- |
device network status | Snipe-IT connection status | -- |
device network search | Search Snipe-IT by MAC/IP | -- |
Standalone commands
| Command | Description |
|---|
device version | Show version |
device show-config | Show current configuration |