Skip to main content
Interact with Status Data from the command line. Browse third-party services from the catalog, check their status, view uptime history and incidents, and manage your tracked dependencies.

Commands

The status-data surface spans two command groups:

Service catalog

CommandDescription
devhelm services listBrowse the service catalog
devhelm services get <slug>Get full detail for a service
devhelm services status <slug>Lightweight live-status snapshot
devhelm services summaryGlobal status summary across the whole catalog
devhelm services components <slug>List a service’s components
devhelm services categoriesList categories with service counts
devhelm services uptime <slug>View uptime history for a service or component
devhelm services incidents [slug] [incident-id]List incidents, or show one incident’s full timeline
devhelm services maintenances <slug>List scheduled maintenances

Dependencies

CommandDescription
devhelm dependencies listList your tracked dependencies
devhelm dependencies get <id>Get dependency details
devhelm dependencies track <slug>Add a service as a dependency
devhelm dependencies update <id>Change alert sensitivity
devhelm dependencies delete <id>Remove a dependency

services list

Browse the catalog. Cursor-paginated.
devhelm services list
devhelm services list --search stripe
devhelm services list --category cloud-infrastructure
FlagTypeDefaultDescription
--searchstringCase-insensitive match on service name or slug
--categorystringFilter by category (exact match)
--statusstringFilter by current overall status
--limitint20Page size (1–100)
--cursorstringOpaque cursor from a previous response

services get

Get the full service profile: current status, components, recent incidents, uptime summary.
devhelm services get github
devhelm services get stripe -o json

services status

Lightweight live-status snapshot — current overall status, component statuses, and active incident count. Ideal for polling.
devhelm services status github

services summary

Global status summary: counts of operational / degraded / down services across the entire catalog, with the list of currently affected services.
devhelm services summary

services components

List a service’s components with current status. Use this to find component IDs for component-level dependencies.
devhelm services components github

services categories

devhelm services categories

services uptime

View uptime history for a catalog service, or for a single component with --component.
devhelm services uptime aws-ec2
devhelm services uptime aws-ec2 --period 90d --granularity daily
devhelm services uptime github --component <component-id> --period 30d
FlagTypeDefaultDescription
--periodstring30dTime period: 7d, 30d, 90d
--granularitystringData granularity: hourly, daily (service-level only)
--componentUUIDShow uptime for this component instead of the whole service
--from / --tostringCustom ISO 8601 date range (requires --component)
Find component IDs with devhelm services components <slug>.

services incidents

List vendor incidents, or show one incident in full. With a slug, lists that service’s incident history; without, lists incidents across all services. Add an incident ID after the slug to see the complete vendor timeline for a single incident.
devhelm services incidents github --status active
devhelm services incidents --status active
devhelm services incidents github <incident-id>
FlagTypeDefaultDescription
--statusstringactive or resolved
--fromstringEarliest start date (ISO 8601)

services maintenances

List scheduled maintenance windows announced by the vendor.
devhelm services maintenances github
devhelm data services status and devhelm data services uptime from earlier CLI versions keep working as aliases of services status and services uptime.

dependencies list

List all services you’re tracking as dependencies.
devhelm dependencies list

dependencies get

devhelm dependencies get <subscription-id> -o json

dependencies track

Add a service from the catalog as a dependency. Once tracked, DevHelm monitors its status and routes incidents through your notification policies.
devhelm dependencies track github
devhelm dependencies track stripe --alert-sensitivity INCIDENTS_ONLY
devhelm dependencies track github --component <component-id>
FlagTypeDefaultDescription
--alert-sensitivitystringAWARENESSAWARENESS, INCIDENTS_ONLY, MAJOR_ONLY, or ALL
--componentUUIDTrack only this component instead of the whole service

dependencies update

Change alert sensitivity for an existing dependency.
devhelm dependencies update <subscription-id> --alert-sensitivity MAJOR_ONLY

dependencies delete

Stop tracking a service.
devhelm dependencies delete <subscription-id>

Next steps

Status Data overview

Understanding the service catalog and dependency tracking.

Tracking dependencies guide

Step-by-step guide for adding third-party dependencies.