gleam-lsp

gleam-lsp

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

Features

• 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

Requirements

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.

Installation

/plugin install gleam-lsp@alvivi

Or install from a local clone:

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

Usage

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.

Troubleshooting

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

License

MIT