Skip to main content

Parent Directory Search and Git Root Discovery

· One min read
Andriy Knysh
Andriy Knysh
Principal Architect @ Cloud Posse

Atmos now searches parent directories for atmos.yaml and discovers .atmos.d/ at the git repository root, making it easier to run commands from anywhere in your project.

Atmos now automatically searches parent directories for atmos.yaml when not found in the current directory. Run Atmos from any subdirectory without specifying --config-path:

cd /repo/components/terraform/vpc
atmos terraform plan vpc -s prod  # Finds /repo/atmos.yaml automatically

Git Root Discovery for .atmos.d/​

Atmos automatically discovers .atmos.d/ at your git repository root, even when running from subdirectories. Define shared custom commands once at the repo root and use them from anywhere.

repo/
├── .atmos.d/
│   └── commands.yaml    # Available repo-wide
├── atmos.yaml
└── components/terraform/vpc/
    └── main.tf          # Run atmos from here

Documentation​

  • CLI Configuration — Parent directory search, git root discovery, and .atmos.d/ auto-imports