gleam-lsp

A Claude Code plugin that integrates the Gleam language server, giving Claude code intelligence for .gleam files.

Type errors on edit — Claude sees diagnostics immediately after modifying a file, without running gleam build
Go to definition — navigate to where functions, types, and modules are defined
Find references — locate all usages of a symbol across the project
Hover type info — inspect inferred types without leaving the editor
Symbol navigation — list and jump to symbols within a file or workspace

The Gleam compiler must be installed and available in your $PATH. The language server is bundled with it — no separate install needed.

# Verify your installation
gleam --version
which gleam

Install Gleam via your package manager or from gleam.run/getting-started.

/plugin install gleam-lsp@alvivi

Or install from a local clone:

git clone https://github.com/alvivi/gleam-lsp
claude --plugin-dir ./gleam-lsp

Once installed, Claude Code automatically starts the Gleam language server when you open a .gleam file. No additional configuration is required.

Press Ctrl+O when the "diagnostics found" indicator appears to view errors inline.
Code navigation commands (go to definition, find references) are available automatically.

Language server not starting

Check the /plugin Errors tab. The most common cause is gleam not being in $PATH. Verify with:

which gleam

If you installed Gleam via asdf or another version manager, make sure the shims directory is in your $PATH.

High memory usage

Disable the plugin temporarily:

/plugin disable gleam-lsp

MIT

What's Inside