Skip to main content

spin

The spin step type runs a command behind an animated spinner — the same progress indicator Atmos uses for long-running operations — so your custom commands and workflows show clean, compact progress instead of noisy output.

steps:
- name: build
type: spin
title: Building application
command: npm run build
timeout: 60s

Fields

command
Required. Command to run while the spinner is active.
title
Optional spinner title.
timeout
Optional duration limit, such as 30s or 2m.
working_directory
Optional directory where the command runs.

Use spin when the command output is less useful than a compact progress indicator.