cloudposse / cloudposse/atmos

Atmos doesn't like shared .tool-versions

Open
#2,256 2 comments 0 reactions 1 assignee Claimed by @osterman View on GitHub
bug
Dominant language
Go
Stars
1.4k
Forks
175
Avg merge
2d 3h
Merged PRs (30d)
134

Description

### Describe the Bug

I have a `.tool-versions` file that contains:

```
nodejs 25.8.1
packer 1.15.0
terraform 1.14.5
```

`packer` and `terraform` are used by `atmos` however `nodejs` is used by [setup-node](https://github.com/actions/setup-node). If you attempt to run an atmos workflow it will exit with the error:

```
INFO Executing command="atmos workflow packer-up --file organization/github.yaml --from-step \"build github-5\""

Error

Error: failed to install dependencies: tool installation failed: invalid tool specification: tool not in registry

## Explanation

Failed to install dependencies

## Hints

💡 Add an alias in atmos.yaml:

toolchain:
aliases:
nodejs: owner/repo

💡 Or use full format: owner/repo (e.g., hashicorp/terraform)

💡 Run 'atmos toolchain registry search' to browse available tools

💡 See https://atmos.tools/cli/commands/toolchain/ for toolchain configuration

💡 See https://atmos.tools/cli/commands/toolchain/aliases for configuring aliases
```

### Expected Behavior

atmos should be able to coexist with other tools that use `.tool-versions`.

### Steps to Reproduce

_No response_

### Screenshots

_No response_

### Environment

`Atmos 1.210.1 on darwin/arm64`

### Additional Context

_No response_

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.