ansible-lsp

ansible-lsp

Ansible language server plugin for Claude Code, providing code intelligence features like diagnostics, auto-completion, hover documentation, and go-to-definition for Ansible playbooks and roles.

Powered by @ansible/ansible-language-server (>= 26.4.4).

Features

• Real-time validation via ansible-lint (falls back to ansible --syntax-check)
• Smart auto-completion for plays, blocks, tasks, and module options
• Hover documentation for Ansible keywords, modules, and module options
• Go-to-definition for module source code

Supported Extensions

.yml, .yaml

Installation

# Install the Ansible language server
npm install -g @ansible/ansible-language-server

From the official marketplace (once published)

Search for "ansible-lsp" in the /plugin Discover tab, or:

claude plugin install ansible-lsp

Local development / testing

claude --plugin-dir /path/to/claude-ansible-lsp

Requirements

• Node.js >= 18
• Ansible 2.9+
• ansible-lint (recommended, for full validation support)
• @ansible/ansible-language-server >= 26.4.4 (npm install -g @ansible/ansible-language-server)

Known Limitations

• Some LSP clients (including Claude Code) do not support client/registerCapability requests. ALS >= 26.4.3 handles this gracefully, but as a result:
  • Changes to ansible.cfg, .ansible-lint, or role meta/main.yml files require a server restart to take effect
  • Dynamic configuration change notifications are not received

More Information

• @ansible/ansible-language-server on npm
• Ansible Language Server documentation
• Upstream fix: ansible/vscode-ansible#2753