Skip to main content

atmos toolchain registry list

List all configured registries or browse all tools available in a specific registry. View installation status, registry metadata, and discover new tools for your infrastructure workflows.

atmos toolchain registry list --help

Usage​

List All Registries​

atmos toolchain registry list

Shows all configured registries with their names, types, and tool counts.

List Tools in a Registry​

atmos toolchain registry list <registry-name>

Displays all tools available in the specified registry with installation status indicators.

Examples​

List Configured Registries​

atmos toolchain registry list

Output:

Available registries:

Default built-in registries:
  - aqua-public (aqua, priority: 10)

Use 'atmos toolchain registry list aqua' to see tools in the Aqua registry.

Browse Aqua Registry Tools​

atmos toolchain registry list aqua

Shows a paginated table of all tools in the Aqua registry with installation status:

  • Green dot (●) = Tool is installed
  • Gray dot (●) = Tool is in .tool-versions but not installed
  • No indicator = Tool is available but not configured

List with Pagination​

# Show first 20 tools
atmos toolchain registry list aqua --limit 20

# Skip first 50 tools, show next 25
atmos toolchain registry list aqua --offset 50 --limit 25

Output as JSON or YAML​

# JSON output for scripting
atmos toolchain registry list aqua --format json

# YAML output
atmos toolchain registry list aqua --format yaml

Sort Results​

# Sort by name (default)
atmos toolchain registry list aqua --sort name

# Sort by date (if supported by registry)
atmos toolchain registry list aqua --sort date

# Sort by popularity (if supported by registry)
atmos toolchain registry list aqua --sort popularity

Arguments​

registry-name (optional)

Name of the registry to list tools from. If omitted, lists all configured registries.

Supported values:

  • aqua or aqua-public - Official Aqua registry
  • Custom registry names from atmos.yaml configuration

Flags​

--limit (optional)

Maximum number of tools to display. Default: 50

Environment variable: ATMOS_TOOLCHAIN_LIMIT

--offset (optional)

Skip first N tools (for pagination). Default: 0

Environment variable: ATMOS_TOOLCHAIN_OFFSET

--format (optional)

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

Environment variable: ATMOS_TOOLCHAIN_FORMAT

--sort (optional)

Sort order. Options: name, date, popularity. Default: name

Environment variable: ATMOS_TOOLCHAIN_SORT

--pager / --no-pager (optional)

Enable or disable pagination using a pager (less-like viewer). When enabled, long output is displayed in a scrollable interface.

Default: enabled for table output, disabled for JSON/YAML

Installation Status Indicators​

The table output shows visual indicators for each tool's status:

IndicatorMeaningExample
Green dot (●)Tool is installed and ready to use● hashicorp terraform
Gray dot (●)Tool is in .tool-versions but not installed yet● opentofu opentofu
No indicatorTool is available but not configuredkubernetes-sigs kubectl

To install a tool shown in the list:

# Install specific version
atmos toolchain install <owner/repo>@<version>

# Add to .tool-versions and install
atmos toolchain add <owner/repo>@<version>

Use Cases​

Explore Available Tools​

Browse the Aqua registry to discover infrastructure tools:

atmos toolchain registry list aqua --limit 100

Scroll through 1,000+ tools including terraform, kubectl, helm, aws-cli, and more.

Check What's Installed​

See which registry tools you already have installed:

atmos toolchain registry list aqua | grep "●"

Green dots indicate installed tools, gray dots show tools in your config.

Export Tool List for CI/CD​

Generate a machine-readable list of available tools:

atmos toolchain registry list aqua --format json > available-tools.json

Use this in scripts to validate tool availability or generate reports.

Paginate Through Results​

Work with large registries using pagination:

# View tools 1-50
atmos toolchain registry list aqua --limit 50

# View tools 51-100
atmos toolchain registry list aqua --offset 50 --limit 50

# View tools 101-150
atmos toolchain registry list aqua --offset 100 --limit 50

Registry Metadata​

When listing tools from a registry, the command displays helpful metadata:

Showing 1-50 of 1,234 tools from registry 'aqua-public' (aqua)
Source: https://github.com/aquaproj/aqua-registry/tree/main/pkgs

This includes:

  • Range - Which tools are currently displayed (e.g., 1-50 of 1,234)
  • Total count - Total number of tools in the registry
  • Registry name - The registry being queried
  • Registry type - Type of registry (aqua, custom, etc.)
  • Source - Where the registry data comes from