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

Usage Examples

Once the plugin is installed, open an Ansible playbook in Claude Code and try these prompts.

1. Search & Navigate Ansible Code

Claude can understand the structure of your playbook and locate specific module usage without grepping.

Open examples/webapp-deploy.yaml and try:

Find all uses of the debug module in this playbook.

Claude will use the LSP to locate each matching task and return the file and line number.

2. Detect & Fix Errors

Claude can validate your playbook and propose fixes without running it.

Open examples/broken-playbook.yaml and try:

Check this playbook for errors and fix any issues you find.

Claude will read the LSP diagnostics, explain what's wrong, and edit the file to fix the errors.

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