# 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

**File:** `atmos.yaml`

```yaml
lsp:
  enabled: true
```

## Configuration Reference

### Top-Level Structure

**File:** `atmos.yaml`

```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](/lsp/lsp-server)** — Set up IDE integration with the Atmos LSP server
- **[LSP Client](/lsp/lsp-client)** — Connect external LSP servers for AI-powered validation

## Related Commands