Skip to main content

Omni

@mccormick/omniv2026.05.21.1· 1d agoMODELS
01README

Talos node discovery for swamp, via Sidero Omni. Omni is the control plane for fleets of Talos Linux machines. The @mccormick/omni/inventory model asks Omni for that fleet state and turns it into a typed swamp inventory: one node resource per managed machine (hardware, network, Talos version, cluster role, connection and readiness state), one cluster resource per cluster with rolled-up machine counts, and a single summary roll-up. The discover method fans out across Omni's COSI resources — machine statuses, cluster-machine statuses, machine identities, and clusters — and merges them by machine UUID in one execution. Read-only: the model only issues omnictl get calls and never mutates Omni state. Transport is the omnictl CLI authenticated with an Omni service account passed through the environment; the service-account key is supplied through a vault, marked sensitive, and redacted from logs and error text.

02Models1
@mccormick/omni/inventoryv2026.05.21.1inventory.ts

Global Arguments

ArgumentTypeDescription
endpointstringOmni API endpoint, e.g. https://omni.example.net
serviceAccountKeystringOmni service-account key (OMNI_SERVICE_ACCOUNT_KEY); supply via
insecureSkipTlsVerifybooleanSkip TLS verification for the Omni API (use only for self-signed certs)
omnictlPathstringPath to the omnictl binary; override when it is not on PATH
fn discover()
Query Omni for every managed Talos machine and cluster and write

Resources

node(30d)— An Omni-managed Talos machine
cluster(30d)— A Talos cluster managed by Omni
summary(30d)— Roll-up of one Omni inventory run
03Stats
A
100 / 100
Downloads
5
Archive size
18.5 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License declared1/1earned
  • Verified public repository2/2earned
04Platforms
05Labels