# atmos config get

Read a value from the effective, fully-merged Atmos configuration using a dot-notation path.

`atmos config get` reports the same configuration Atmos actually uses for this invocation —
every `--config` file, `--config-path` directory, and profile merged together in precedence
order — not just what a single physical `atmos.yaml` file declares on its own. If you need to
inspect or edit one file's own declared value directly, use `atmos config format` or open the
file.

## Usage

```shell
atmos config get <path>
```

## Examples

```shell
atmos config get logs.level
atmos config get components.terraform.base_path
atmos config get logs.level --config ./atmos.yaml
atmos config get stacks.included_paths --config ./main.yaml,./overrides.yaml
```

## Arguments

- **`<path>` (required)** — Dot-notation path to the value (e.g. `logs.level`, `components.terraform.base_path`). Array elements use bracket indices (e.g. `import[0]`).

## Flags

- **`--format` / `-f` (string)** — Output format: `raw` (default) or `json`. JSON preserves scalar and collection types, including quoted strings that look like booleans or numbers. Environment variable: `ATMOS_CONFIG_GET_FORMAT`. The flag overrides the variable.
- **`--config` (string slice, inherited)** — Select one or more `atmos.yaml` files instead of the location discovered in the current directory or git root. When multiple files are given, later files override earlier ones and the merged result is what `get` reports.

## Try it out

### cli-config-imports

Copy the example into a new directory and make it your own:

```shell
atmos init examples/cli-config-imports
cd cli-config-imports
```

Read the logging level from the example CLI configuration.

```shell
atmos config get logs.level
```

- [Installation guide](/install)
- [Explore the example](/examples/cli-config-imports)
- [Initialization and repository settings](/cli/commands/init#examples-and-source-directories)