Skip to main content

Atmos AI

Atmos integrates AI directly into infrastructure management, providing intelligent assistance for understanding configurations, analyzing stacks, troubleshooting issues, and automating workflows.

Experimental

Quick Start​

atmos.yaml

ai:
  enabled: true
  default_provider: "anthropic"
  providers:
    anthropic:
      model: "claude-sonnet-4-6"
      api_key: !env "ANTHROPIC_API_KEY"

shell

export ANTHROPIC_API_KEY="your-api-key"
atmos ai chat                                        # Interactive chat
atmos ai ask "What stacks do we have?"               # Single question
atmos ai exec "validate stacks" --format json        # CI/CD automation
atmos ai sessions list                               # List sessions
atmos ai skill list                                  # List installed skills

AI Configuration

Configure AI providers, models, API keys, skills, tools, sessions, and instructions in your atmos.yaml.

Example​

Try the Example

Explore a complete multi-region infrastructure example with Atmos AI, skills, sessions, and tool execution.

Commands​

atmos ai chat
Interactive chat with session management, provider switching, and skill selection.
atmos ai ask
Ask a single question and get an immediate response. Ideal for scripting and CI/CD.
atmos ai exec
Execute Atmos and shell commands via AI prompts with structured output.
atmos ai sessions
Manage chat sessions: list, clean, export, and import.
atmos ai skill
Install, list, and uninstall community AI skills from GitHub.
atmos mcp start
Start the MCP server with stdio (default) or HTTP transport.
atmos lsp start
Start the LSP server with stdio, TCP, or WebSocket transport.

AI Assistants​

Configure AI Assistants

Set up Claude Code, Cursor, Windsurf, GitHub Copilot, Gemini CLI, OpenAI Codex, and other AI coding assistants to use Atmos agent skills.

Claude Code Integration​

Claude Code Integration

Use Claude Code with the Atmos MCP server and create specialized atmos-expert subagents for deep infrastructure expertise.

Agent Skills​

Atmos ships 21+ agent skills that give AI coding assistants deep knowledge of Atmos conventions. Skills follow the Agent Skills open standard and work across Claude Code, Gemini CLI, OpenAI Codex, Cursor, Windsurf, GitHub Copilot, and more.

Agent Skills Overview​

How skills work, available skills, and the SKILL.md format.

Skill Marketplace​

Install and share community skills from GitHub.

Skills Configuration​

Configure skills in atmos.yaml.

MCP Server​

The Model Context Protocol (MCP) server exposes Atmos AI tools to any compatible client -- Claude Desktop, Claude Code, VS Code, Cursor, Gemini CLI, and many others. This lets you use Atmos tools inside your preferred AI assistant without custom integrations.

MCP Setup

Configure MCP clients and manage tool permissions.

Troubleshooting​

Having issues? See the Troubleshooting Guide for solutions to common problems with providers, tools, sessions, and connectivity.