# atmos toolchain remove

Remove tool entries from your toolchain configuration when they're no longer needed by your components, commands, or workflows. This keeps your toolchain lean and focused on active dependencies.

## Usage

Execute the `toolchain remove` command like this:

```shell
atmos toolchain remove <tool>@<version>
```

## Examples

```shell
atmos toolchain remove terraform
atmos toolchain remove hashicorp/terraform
atmos toolchain remove terraform@1.11.4
atmos toolchain remove hashicorp/terraform@1.11.4
atmos toolchain remove --file /path/to/.tool-versions kubectl@1.28.0
```

## Arguments

- **`tool` (required)**

  Tool to remove from the toolchain configuration. Can be a short name (alias) or full `owner/repo` format.
  Optionally include `@version` to remove only a specific version.

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

## Flags

- **`--file`  (optional)**

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