# 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.

```yaml
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.