# atmos toolchain add

Add new toolchain dependencies that your Atmos components, commands, and workflows require. This command registers CLI tools from Aqua repositories in your toolchain configuration, making them available for use across your infrastructure.

## Usage

Execute the `atmos toolchain add` command like this:

```shell
atmos toolchain add <tool[@version]>...
```

## Examples

```shell
# Add a tool with a specific version
atmos toolchain add hashicorp/terraform@1.5.0

# Add a tool (defaults to latest version)
atmos toolchain add terraform

# Add multiple tools at once
atmos toolchain add terraform@1.5.0 kubectl@1.28.0 opentofu@1.7.0

# Use a custom tool-versions file
atmos toolchain add --tool-versions ./custom/.tool-versions terraform@1.5.0
```

## Arguments

- **`tool[@version]` (required, repeatable)**

  Tool to add from the registry. Can be a short name (alias) or full `owner/repo` format.
  Version is optional - if omitted, defaults to `latest`.

  Format: `tool@version` or `owner/repo@version`

  Examples: `terraform`, `terraform@1.5.0`, `hashicorp/terraform@1.5.0`

## Flags

- **`--tool-versions` (optional, global)**

  Path to tool-versions file (default: `.tool-versions`)