atmos config

Your atmos.yaml configures how Atmos works in your project, including where to find components and stacks and how to run your tools. Use atmos config to inspect those settings, automate changes in setup scripts or CI, and validate your configuration. Edits preserve comments, YAML anchors, Atmos YAML functions, and Go templates.

Usage

atmos config get <path>
atmos config set <path> <value> [--type <type>]
atmos config delete <path>
atmos config list [path-pattern] [--format <format>]
atmos config format
atmos config schema [output-path]
atmos config validate

By default these commands target the atmos.yaml (or .atmos.yaml) in the current directory or git root. Use the global --config flag to target a specific file.

Subcommands

• atmos config get — read a value by path.
• atmos config set — set a value by path.
• atmos config delete — delete a value by path.
• atmos config list — list editable setting paths.
• atmos config format — format the active atmos.yaml file.
• atmos config schema — print the JSON Schema for atmos.yaml.
• atmos config validate — validate atmos.yaml against its JSON Schema.

Examples

# Read the configured log level.
atmos config get logs.level

# Set a string value.
atmos config set logs.level Debug

# Set a typed (boolean) value.
atmos config set --type=bool components.terraform.apply_auto_approve true

# Delete a value.
atmos config delete logs.file

# List every editable path.
atmos config list

# Format the active atmos.yaml file.
atmos config format

# Target a specific file.
atmos config set logs.level Trace --config ./atmos.yaml