Skip to main content

atmos toolchain info

Display detailed information about a toolchain tool from the registry, including download sources, available versions, and package metadata. This helps you verify tool configuration and understand how tools are resolved.

atmos toolchain info --help

Usage​

Execute the atmos toolchain info command like this:

atmos toolchain info <tool>

Examples​

View Tool Information​

atmos toolchain info terraform

Example output:

Tool Information: hashicorp/terraform

  Name:         terraform
  Owner:        hashicorp
  Repository:   terraform
  Type:         github_release
  Registry:     aqua-public

  Description:  Terraform enables you to safely and predictably create,
                change, and improve infrastructure.

  Source URL:   https://releases.hashicorp.com/terraform/{{.Version}}/
                terraform_{{.Version}}_{{.OS}}_{{.Arch}}.zip

  Latest Versions:
    1.9.8 (latest)
    1.9.7
    1.9.6
    1.9.5
    1.9.4

  Installed Versions:
    ● 1.9.8 (default)
    ● 1.8.5

  Configured Version: 1.9.8 (from .tool-versions)

View with JSON Output​

atmos toolchain info terraform --format json

Example output:

{
  "name": "terraform",
  "owner": "hashicorp",
  "repo": "terraform",
  "type": "github_release",
  "registry": "aqua-public",
  "description": "Terraform enables you to safely and predictably create, change, and improve infrastructure.",
  "url_template": "https://releases.hashicorp.com/terraform/{{.Version}}/terraform_{{.Version}}_{{.OS}}_{{.Arch}}.zip",
  "latest_version": "1.9.8",
  "installed_versions": ["1.9.8", "1.8.5"],
  "configured_version": "1.9.8"
}

View Using Alias​

atmos toolchain info tf
atmos toolchain info tofu

View Using Full Path​

atmos toolchain info hashicorp/terraform
atmos toolchain info kubernetes-sigs/kubectl

Arguments​

tool (required)

Tool to display information about. Can be a short name (alias) or full owner/repo format.

Examples: terraform, tf, hashicorp/terraform, kubectl

Flags​

--format (optional)

Output format: table, json, or yaml. Default: table

Environment variable: ATMOS_TOOLCHAIN_FORMAT

--show-versions (optional)

Number of latest versions to display. Default: 5

Environment variable: ATMOS_TOOLCHAIN_SHOW_VERSIONS

Information Displayed​

FieldDescription
NameTool name (repository name)
OwnerGitHub organization or user
RepositoryFull owner/repo path
TypePackage type (github_release, http)
RegistrySource registry name
DescriptionTool description from registry
Source URLDownload URL template
Latest VersionsRecent versions available
Installed VersionsVersions installed locally
Configured VersionVersion from .tool-versions

Use Cases​

Verify Tool Configuration​

Check how a tool is configured before installing:

# View tool details
atmos toolchain info terraform

# Check download URL
atmos toolchain info kubectl --format json | jq '.url_template'

Check Available Versions​

See what versions are available:

# Show more versions
atmos toolchain info terraform --show-versions 20

# Get latest version programmatically
atmos toolchain info terraform --format json | jq -r '.latest_version'

Debug Installation Issues​

Understand why a tool might not be found:

# Check registry and type
atmos toolchain info unknown-tool
# Error: tool 'unknown-tool' not found in any registry

# Verify alias resolution
atmos toolchain info tf
# Shows: hashicorp/terraform (resolved from alias)

Compare Tool Sources​

Understand where tools come from:

# HashiCorp uses their own CDN
atmos toolchain info terraform

# Most tools use GitHub releases
atmos toolchain info tflint

Export for Documentation​

Generate tool documentation:

# Export as YAML
atmos toolchain info terraform --format yaml > docs/terraform-info.yaml

# Export as JSON for automation
atmos toolchain info kubectl --format json > kubectl-metadata.json

Notes​

  • Tool information comes from the configured registries
  • Aliases are automatically resolved to full owner/repo format
  • Version availability depends on what the registry provides
  • Installed versions are checked from the local toolchain directory