# atmos git status

Report the working tree status of a repository configured under [`git.repositories`](/cli/configuration/git), or of any local path. Changed entries are written to stdout in porcelain format (one `CODE path` line per entry), so the output is pipeable; a clean tree is reported as a human-readable message on stderr.

## Usage

```shell
atmos git status [name-or-path] [flags]
```

With a configured repository:

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

```shell
atmos git status flux-deploy
```

## Examples

```shell
# Status of a named managed repository
atmos git status flux-deploy

# Status of the single configured repository
atmos git status

# Status of a repository at a local path
atmos git status ./deployments

# Status of all configured repositories
atmos git status --all

# Pipe the porcelain output
atmos git status flux-deploy | grep '^ M'
```

## Arguments

- **`name-or-path` (required unless exactly one repository is configured, or `--all` is set)**

  A repository name configured under `git.repositories`, or a filesystem path to an existing Git working tree. When exactly one repository is configured, omitting this argument reports status for that repository. Use an explicit path prefix (`./deployments`) to force path interpretation when an argument collides with a repository name.

## Flags

- **`--all` (optional)**

  Report status for every repository configured under `git.repositories`, concurrently. Every repository is attempted; failures are aggregated and reported at the end. Mutually exclusive with a positional argument.
  Environment variable: `ATMOS_GIT_STATUS_ALL`
- **`--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 diff`](/cli/commands/git/diff) — show the actual content changes
- [`atmos git list`](/cli/commands/git/list) — list configured repositories (`--check-status` shares this status probe)
- [Git Configuration](/cli/configuration/git) — repository fields and defaults