# atmos toolchain versions

Browse available versions of any toolchain tool before installing or upgrading. This helps you select the right version for your components and workflows, whether you need the latest features or a stable release.

## Usage

Execute the `toolchain versions` command like this:

```shell
atmos toolchain versions <tool>
```

## Examples

```shell
atmos toolchain versions terraform
atmos toolchain versions terraform --all
atmos toolchain versions terraform --limit 10
atmos toolchain versions terraform --file path-to-config
```

## Arguments

- **`tool` (required)**

  Tool to get versions for. Can be a short name (alias) or full `owner/repo` format.

  Examples: `terraform`, `kubectl`, `hashicorp/terraform`

## Flags

- **`--all`  (optional)**

  List all the versions available for the package
- **`--limit`  (optional)**

  Max number of versions to be displayed
- **`--file`  (optional)**

  Path to tool-versions file (defaults to global --tool-versions-file)