Skip to main content

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.

atmos toolchain add --help

Usage​

Execute the atmos toolchain add command like this:

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

Examples​

# 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)