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
TheBushidoCollective
sigridjineth
basher83
jeremylongshore
boostvolt
xobotyi