Skip to main content

atmos git list

List the repositories configured under git.repositories 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.

atmos git list --help

Usage​

atmos git list [flags]

With repositories configured in atmos.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
atmos git list
atmos list git-repositories     # alias

Examples​

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

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