atmos ai
Atmos AI is a built-in assistant that understands your stacks, components, and configuration.
Ask questions, debug issues, or automate infrastructure tasks directly from the terminal.
It supports multiple providers (Anthropic, OpenAI, Gemini, Ollama, AWS Bedrock, Azure OpenAI)
and 21+ specialized skills you can switch between with Ctrl+A.
Configure AI
Learn how to configure AI providers, skills, tools, and sessions in your atmos.yaml.
Global --ai Flag
You can also add --ai to any Atmos command to get AI-powered analysis of the output — no need
to use atmos ai subcommands. Pair with --skill for domain-specific expertise
(the --skill flag requires --ai). Multiple skills can be combined with commas or repeated flags.
# AI analyzes the terraform plan output
atmos terraform plan vpc -s ue1-prod --ai
# AI uses Terraform expertise for deeper analysis
atmos terraform plan vpc -s ue1-prod --ai --skill atmos-terraform
# Combine multiple skills (comma-separated)
atmos terraform plan vpc -s ue1-prod --ai --skill atmos-terraform,atmos-stacks
# Combine multiple skills (repeated flag)
atmos terraform plan vpc -s ue1-prod --ai --skill atmos-terraform --skill atmos-stacks
# Enable via environment variables
ATMOS_AI=true ATMOS_SKILL=atmos-terraform,atmos-stacks atmos terraform plan vpc -s ue1-prod
See Global Flags for details.
Subcommands
📄️ ask
Ask the AI assistant a question directly from the command line
📄️ chat
Start an interactive AI chat session with the Atmos AI assistant
📄️ exec
Run Atmos and shell commands via AI prompts non-interactively for automation and CI/CD integration
📄️ sessions
Manage AI chat sessions including list, clean, export, and import operations
📄️ skill
Manage AI skills including install, list, and uninstall operations