Skip to main content

Real-Time Instance Status from Atmos CLI to Atmos Pro

· 3 min read
Daniel Miller
Daniel Miller
Staff Engineer @ Cloud Posse

For teams using Atmos Pro, the Atmos CLI now pushes instance status directly to the Atmos Pro dashboard the moment a plan or apply completes. The dashboard reflects the real state of every component within seconds — no polling, no waiting for webhooks, no stale data.

Live Infrastructure Status​

Atmos Pro gives teams a real-time view of every infrastructure component across all environments. With this release, the status pipeline gets significantly faster: the CLI reports results to Atmos Pro immediately after each terraform operation completes.

When you run atmos terraform plan or atmos terraform deploy with --upload-status, the CLI sends the raw execution result to Atmos Pro. The dashboard updates within seconds, showing whether each component is in sync, has drift, or encountered an error — across every stack, every environment, at a glance.

How It Works​

The CLI sends the raw command and exit code to Atmos Pro, which interprets the result server-side. This means Atmos Pro can refine how it classifies status without requiring a CLI update. The CLI stays simple — it just reports what happened.

# Plan with status reporting
atmos terraform plan mycomponent -s prod-use1 --upload-status

# Apply with status reporting
atmos terraform deploy mycomponent -s prod-use1 --upload-status

In CI workflows, add --upload-status to your plan and apply steps. Combined with the new CI exit code mapping, your workflows stay green while Atmos Pro captures the full picture:

# atmos.yaml
ci:
  enabled: true

components:
  terraform:
    ci:
      exit_codes:
        0: true    # no changes → CI success
        1: false   # error → CI failure
        2: true    # changes detected → CI success

Why This Matters​

Infrastructure teams managing hundreds of components need to know the state of their deployments at all times. Before this change, status updates depended on webhook processing and background reconciliation — introducing delays and gaps. Now the CLI closes that loop directly:

  • Instant feedback — dashboard updates seconds after plan or apply finishes
  • Complete coverage — both plan and apply report status, including errors
  • Zero configuration drift — Atmos Pro always reflects the latest execution result
  • CI-native — works seamlessly in GitHub Actions, GitLab CI, or any CI system

If you're managing infrastructure at scale, Atmos Pro turns your CLI output into a shared, real-time operational view for the entire team.

For usage and configuration, see atmos list instances.