Skip to main content

atmos git status

Report the working tree status of a repository configured under git.repositories, 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.

atmos git status --help

Usage​

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

With a configured repository:

git:
  repositories:
    flux-deploy:
      uri: https://github.com/acme/flux-deploy.git
atmos git status flux-deploy

Examples​

# 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