Skip to main content

atmos toolchain registry

Manage and explore toolchain registries. View available tools, search across registries, and discover new CLI tools to add to your infrastructure workflows.

atmos toolchain registry --help

Overview​

The atmos toolchain registry commands provide access to toolchain registries like the Aqua registry, enabling you to:

  • Explore available tools - Browse 1,000+ CLI tools from configured registries
  • Search for tools - Find tools by name, owner, or description
  • View registry information - See tool counts, sources, and registry metadata
  • Check installation status - See which tools are installed vs. available

Subcommands​

list [registry-name]
List all configured registries or tools from a specific registry
search <query>
Search for tools across all configured registries

Registry Types​

Atmos supports multiple registry types with priority-based precedence:

Aqua Registry (Default)​

The official Aqua registry provides:

  • 1,000+ pre-configured tools
  • Community-maintained definitions
  • GitHub releases and HTTP sources
  • Automatic version detection

Custom Registries​

Configure additional registries in atmos.yaml:

toolchain:
  registries:
    # Corporate/private registry (highest priority)
    - name: corporate
      type: aqua
      source: file://./custom-registry/registry.yaml
      priority: 100

    # Official Aqua registry (fallback)
    - name: aqua-public
      type: aqua
      source: https://github.com/aquaproj/aqua-registry/tree/main/pkgs
      priority: 10

See the Custom Registries section for more details.

Quick Examples​

List All Registries​

atmos toolchain registry list

Shows all configured registries with tool counts and sources.

Browse Registry Tools​

atmos toolchain registry list aqua

Lists all tools available in the Aqua registry with installation status.

Search for Tools​

atmos toolchain registry search terraform

Finds all tools matching "terraform" across all registries, showing which are installed.

Use Cases​

Discover New Tools​

Explore the registry to find tools for your infrastructure workflows:

# Search for Kubernetes tools
atmos toolchain registry search kubernetes

# Search for Terraform-related tools
atmos toolchain registry search terraform

# Search for AWS tools
atmos toolchain registry search aws

Verify Tool Availability​

Check if a tool is available before adding it:

atmos toolchain registry search tflint
atmos toolchain add tflint@0.44.1

Explore Registry Contents​

Browse all available tools in a registry:

# List all tools with pagination
atmos toolchain registry list aqua

# Limit results
atmos toolchain registry list aqua --limit 20

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