Skip to main content

Aliases

Aliases let you create shortcut names for existing CLI commands. Any CLI command can be aliased, including Atmos native commands like terraform apply or describe stacks, as well as custom commands.

Configuration​

CLI command aliases are configured in the aliases section:

atmos.yaml

# CLI command aliases
aliases:
  # Aliases for Atmos native commands
  tf: terraform
  tp: terraform plan
  up: terraform apply
  down: terraform destroy
  ds: describe stacks
  dc: describe component
  # Aliases for Atmos custom commands
  ls: list stacks
  lc: list components

Using Aliases​

Execute an alias as you would any Atmos native or custom command:

'atmos ls' command alias

> atmos ls

plat-ue2-dev
plat-ue2-prod
plat-ue2-staging
plat-uw2-dev
plat-uw2-prod
plat-uw2-staging

Aliases in Help​

The aliases configured in the aliases section automatically appear in Atmos help, shown as alias for '<command>'.

atmos --help

atmos --help

Argument Support​

An alias automatically supports all command line arguments and flags that the aliased command accepts.

For example:

Alias CommandEquivalent To
atmos up <component> -s <stack>atmos terraform apply <component> -s <stack>
atmos dc <component> -s <stack>atmos describe component <component> -s <stack>

Common Aliases​

Here are some commonly used aliases:

aliases:
  # Terraform shortcuts
  tf: terraform
  tp: terraform plan
  up: terraform apply
  down: terraform destroy

  # Describe shortcuts
  ds: describe stacks
  dc: describe component
  da: describe affected

  # Workflow shortcuts
  wf: workflow

  # List shortcuts (requires custom commands)
  ls: list stacks
  lc: list components

See Also​