# atmos git list

List the repositories configured under [`git.repositories`](/cli/configuration/git) with their local clone state, URIs, providers, branches, and resolved workdirs. Built on the standard Atmos list rendering pipeline, with the same column, format, and filter behavior as other `atmos list` commands. Also available as `atmos list git-repositories`.

## Usage

```shell
atmos git list [flags]
```

With repositories configured in `atmos.yaml`:

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

    generated-terraform:
      uri: https://github.com/acme/generated-terraform.git
```

```shell
atmos git list
atmos list git-repositories     # alias
```

## Examples

```shell
# List all configured repositories (default sort: name ascending).
# Default table output shows a green dot for clean clones, yellow for dirty
# clones, and gray for missing workdirs.
atmos git list

# Select columns
atmos git list --columns=name,uri,workdir

# Include status fields when using custom columns
atmos git list --check-status --columns=status,name,workdir

# Machine-readable output
atmos git list --format=json
atmos git list --format=csv --delimiter=";"

# Alias registered under atmos list
atmos list git-repositories --format=yaml
```

## Columns

- **`name`**
  Logical repository name (the key under 
  `git.repositories`
  ).
- **`uri`**
  Repository URI.
- **`provider`**
  Resolved provider (
  `cli`
  ).
- **`branch`**
  Configured branch, or 
  `(default)`
   when the remote default branch is used.
- **`workdir`**
  Resolved workdir — the automatic XDG location or the explicit 
  `workdir`
   override.
- **`status`**
  Colored table indicator for local clone state: green dot for 
  `cloned`
  , yellow dot for 
  `dirty`
  , and gray dot for 
  `missing`
  . In non-TTY output this resolves to the semantic status text.
- **`status_text`**
  `cloned`
  , 
  `missing`
  , or 
  `dirty`
  . Used by machine-readable default output and custom columns that need status text.

Columns can also be customized in `atmos.yaml` under `git.list.columns` — see [Git Configuration](/cli/configuration/git#list-output).

## Flags

- **`--check-status` (optional)**

  Probe each workdir on disk and populate status fields when using custom columns. Default table output already probes status to show the dot column. Probes run concurrently with a bounded worker pool.
- **`--columns` (optional)**

  Comma-separated list of columns to display.
  Environment variable: `ATMOS_GIT_LIST_COLUMNS`
- **`--format` (optional)**

  Output format: `table` (default), `json`, `yaml`, `csv`, or `tsv`.
  Environment variable: `ATMOS_GIT_LIST_FORMAT`
- **`--delimiter` (optional)**

  Field delimiter for `csv`/`tsv` output.
- **`--filter` (optional)**

  YQ expression to filter the listed repositories.
  Environment variable: `ATMOS_GIT_LIST_FILTER`

## Related

- [`atmos git status`](/cli/commands/git/status) — full porcelain status for one repository (shares the `--check-status` probe)
- [`atmos git clone`](/cli/commands/git/clone) — materialize a `missing` workdir
- [Git Configuration](/cli/configuration/git) — `git.repositories` and `git.list`