# atmos helm plan

Preview the changes a Helm apply would make. `plan` is an alias for
[`diff`](/cli/commands/helm/diff): it renders the chart client-side and shows a
unified diff against a baseline (the deployed release, a local manifest file, or
a GitOps deployment repository). See [`diff`](/cli/commands/helm/diff) for the
full description of baselines and flags.

## Usage

```shell
atmos helm plan <component> --stack <stack> [options]

# Diff against the deployed release (requires cluster access).
atmos helm plan monitoring -s plat-ue2-dev

# Diff offline against a local manifest or the GitOps deployment repository.
atmos helm plan monitoring -s plat-ue2-dev --from-manifest=current.yaml
atmos helm plan monitoring -s plat-ue2-dev --against=target

# Plan all components tagged "production" (composes with --all/--affected)
atmos helm plan --all --tags production
```

## Flags

- **`--stack`, `-s` (required)**
  Atmos stack.
- **`--against=<source>` / `--from-manifest=<path>` / `--context=<n>` (optional)**
  Select and tune the diff baseline. See 
  [`diff`](/cli/commands/helm/diff#flags)
  .
- **`--all` / `--affected` / `--include-dependents` (optional)**
  Process multiple Helm components in dependency order.
- **`--tags` / `--labels` (optional)**
  Filter by tags (comma-separated, matches any) or labels (comma-separated 
  `key=value`
   pairs, matches all): 
  `--tags=production,tier-1`
  , 
  `--labels=cost-center=platform`
  . Compose with 
  `--all`
  /
  `--affected`
   to narrow the selected set further; cannot be combined with a single component argument.