al-lsp-for-agents

AL LSP for Agents

AL Language Server wrappers for AI-powered Business Central development. Works with Claude Code, OpenCode, and VS Code (GitHub Copilot agent mode).

Available Wrappers

Wrapper	Platform	Description
al-language-server-go-windows	Windows	Recommended - Go wrapper with Code Lens & Call Hierarchy
al-language-server-go-linux	Linux	Recommended - Go wrapper with Code Lens & Call Hierarchy
al-language-server-go-darwin	macOS	Recommended - Go wrapper with Code Lens & Call Hierarchy
al-language-server-python	Cross-platform	Deprecated - Basic LSP features only

Migration Note: If you're using the Python wrapper, switch to the Go wrapper for your platform to get Code Lens (reference counts) and Call Hierarchy features.

Features

• Hover - Type information and documentation
• Go to Definition - Jump to symbol definitions (tables, codeunits, enums, procedures)
• Document Symbols - List all symbols in a file
• Find References - Find all references to a symbol
• Call Hierarchy - Find incoming and outgoing calls for procedures
• Multi-project support - Workspaces with multiple AL apps

Prerequisites

1. VS Code with the AL Language extension installed

The Go wrappers are compiled binaries with no runtime dependencies. The wrapper automatically finds the newest AL extension version in your VS Code extensions folder.

Installation

OpenCode

One-command setup:

Linux:

curl -fsSL https://raw.githubusercontent.com/SShadowS/al-lsp-for-agents/main/scripts/setup-opencode.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/SShadowS/al-lsp-for-agents/main/scripts/setup-opencode.ps1 | iex

The script downloads the latest binaries, checks for the AL VS Code extension, and configures opencode.json. Run it again to update. Use SCOPE=project to write config to the current directory instead of globally.

Claude Code

1. Enable LSP Tool

# PowerShell (current session)
$env:ENABLE_LSP_TOOL = "1"
claude

# PowerShell (permanent)
[Environment]::SetEnvironmentVariable("ENABLE_LSP_TOOL", "1", "User")

# Bash
export ENABLE_LSP_TOOL=1
claude

2. Add Marketplace

/plugin marketplace add SShadowS/al-lsp-for-agents

3. Install Plugin

1. Type /plugins
2. Tab to Marketplaces
3. Enter al-lsp-for-agents marketplace
4. Select the Go wrapper for your platform:
   • Windows: al-language-server-go-windows
   • Linux: al-language-server-go-linux
   • macOS: al-language-server-go-darwin
5. Press "i" to install
6. Restart Claude Code

LSP Operations

Claude can use these LSP operations on AL files:

Operation	Status	Description
goToDefinition	Working	Go to symbol definition
goToImplementation	Working	Go to implementation
hover	Working	Get type/documentation info
documentSymbol	Working	List symbols in file
findReferences	Working	Find all references
prepareCallHierarchy	Working	Get call hierarchy item at position
incomingCalls	Working	Find callers of a procedure
outgoingCalls	Working	Find calls made by a procedure
workspaceSymbol	Bug	See Known Issues

Known Issues

workspaceSymbol Returns Empty Results

Claude Code's LSP tool has a bug where it doesn't pass the required query parameter for workspaceSymbol. This causes the operation to always return 0 symbols.

Workarounds:

• Use documentSymbol to list symbols in a specific file
• Use Grep to search for symbol names across the workspace

See KnownIssues.md for full details and technical analysis.

License

GNU General Public License v3.0