Skip to main content

atmos git pull

Pull the latest changes for a repository configured under git.repositories, or for any local path. Pulls are always fast-forward-only — Atmos never creates merge commits or rebases on pull, so a diverged branch fails fast instead of producing surprise history.

atmos git pull --help

Usage​

atmos git pull [name-or-path] [flags] [-- <native git args>]

With a configured repository:

git:
  repositories:
    flux-deploy:
      uri: https://github.com/acme/flux-deploy.git
      branch: main
atmos git pull flux-deploy

Examples​

# Pull a named managed repository
atmos git pull flux-deploy

# Pull the single configured repository
atmos git pull

# Clone the single configured repository first when its workdir is missing
atmos git pull --clone

# Pull a repository at a local path
atmos git pull ./deployments

# Pull all configured repositories concurrently
atmos git pull --all

# Clone missing configured workdirs before pulling all repositories
atmos git pull --all --clone

# Pull a specific branch from a specific remote
atmos git pull flux-deploy --remote=origin --branch=main

# Pass native arguments to the underlying git pull invocation
atmos git pull flux-deploy -- --no-tags

Argument Resolution​

The positional argument is resolved as: configured repository name → URI (rejected — pull needs a local workdir) → path. To force path interpretation for an argument that collides with a repository name, use an explicit path prefix (./deployments).

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 pulls that repository.

Flags​

--all (optional)

Fast-forward pull 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_PULL_ALL

--clone (optional)

Clone a configured repository when its workdir is missing. This flag only applies to configured repository names, including no-arg single-repository pull and --all; it is rejected for local path arguments. Environment variable: ATMOS_GIT_PULL_CLONE

--branch / -b (optional)

Branch to pull. Defaults to the repository's configured branch, or the current branch. Environment variable: ATMOS_GIT_BRANCH

--remote (optional)

Remote name. Default: origin. Environment variable: ATMOS_GIT_REMOTE

--identity (optional)

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

Native Git Arguments​

Arguments after -- are passed verbatim to the underlying git pull --ff-only invocation.

atmos git pull flux-deploy -- --no-tags