# atmos git diff

Show uncommitted changes in a repository configured under [`git.repositories`](/cli/configuration/git), or in any local path. This is the read-before-write step of GitOps publishing — the GitOps analog of `terraform plan`: see exactly what _would_ be committed to a deployment repository without committing anything.

## Usage

```shell
atmos git diff <name-or-path> [flags]
```

With a configured deployment repository:

```yaml
git:
  repositories:
    flux-deploy:
      uri: https://github.com/acme/flux-deploy.git
```

```shell
atmos git diff flux-deploy --path=clusters/prod
```

The unified diff is written to stdout (pipeable). Untracked files are reported separately on stderr so they don't corrupt piped diff output.

## Examples

```shell
# Show all uncommitted changes in a managed repository
atmos git diff flux-deploy

# Scope the diff to specific repo-relative paths
atmos git diff flux-deploy --path=clusters/prod --path=clusters/staging

# Diff a repository at a local path
atmos git diff ./deployments

# Pull-request preview in CI: render manifests, then show what would change
atmos git diff flux-deploy --path=clusters/prod > preview.diff
```

## Arguments

- **`name-or-path` (required)**

  A repository name configured under `git.repositories`, or a filesystem path to an existing Git working tree. URIs are not accepted — diff operates on a local workdir.

## Flags

- **`--path` (optional)**

  Limit the diff to these repo-relative paths. Repeatable (`--path=a --path=b`) or comma-separated (`--path=a,b`).
  Environment variable: `ATMOS_GIT_DIFF_PATH`
- **`--identity` (optional)**

  Atmos Auth identity to use for this operation (global flag). Overrides the repository's `auth.identity`.
  Environment variable: `ATMOS_IDENTITY`

## Related

- [`atmos git commit`](/cli/commands/git/commit) — commit the changes shown by diff
- [`atmos git status`](/cli/commands/git/status) — summary view of the working tree
- [Git Configuration](/cli/configuration/git) — repository fields and defaults