Skip to main content

LSP Configuration

The lsp section of the atmos.yaml configures the built-in LSP server and external LSP server connections used by the Atmos AI assistant for validation.

Experimental

Quick Start​

atmos.yaml

lsp:
  enabled: true

Configuration Reference​

Top-Level Structure​

atmos.yaml

lsp:
  enabled: true                          # Enable LSP integration
  servers:                               # External LSP server connections
    yaml-ls:
      command: "yaml-language-server"
      args: ["--stdio"]
      filetypes: ["yaml", "yml"]
      root_patterns: ["atmos.yaml", ".git"]
      initialization_options:
        yaml:
          schemas:
            "https://atmos.tools/schemas/atmos/atmos-manifest/1.0/atmos-manifest.json": "stacks/**/*.yaml"

    terraform-ls:
      command: "terraform-ls"
      args: ["serve"]
      filetypes: ["tf", "tfvars"]
      root_patterns: [".terraform", ".git"]

LSP Settings​

enabled
Enable or disable LSP integration (default: false)

Server Configuration​

Each server in the servers map configures an external LSP server connection:

command
The executable command to run the LSP server (e.g., yaml-language-server, terraform-ls)
args
Command-line arguments passed to the server (e.g., ["--stdio"])
filetypes
List of file extensions this server handles (e.g., ["yaml", "yml"])
root_patterns
Patterns used to identify the workspace root directory (e.g., ["atmos.yaml", ".git"])
initialization_options
Custom LSP initialization options passed to the server on startup. The structure depends on the specific LSP server.

Guides​

  • LSP Server — Set up IDE integration with the Atmos LSP server
  • LSP Client — Connect external LSP servers for AI-powered validation