Atmos Custom Commands

Atmos custom commands extend the CLI with project-specific commands defined in atmos.yaml. They appear in atmos help output alongside built-in commands, providing a unified interface for all operational tooling in a project. Custom commands replace scattered bash scripts with a consistent, discoverable CLI.

What Custom Commands Are

Custom commands are user-defined CLI commands configured in the commands section of atmos.yaml. Each command can have:

• A name and description
• Positional arguments and flags (with shorthand, required/optional, defaults)
• Boolean flags
• Environment variables (supporting Go templates)
• One or more execution steps (shell commands, also supporting Go templates)
• Nested subcommands
• Access to resolved component configuration via component_config
• Authentication via identity
• Tool dependencies
• Working directory control

Custom commands can call Atmos built-in commands, shell scripts, workflows, or any other CLI tools. They are fully interoperable with Atmos workflows.