Check out Piebald

We've released Piebald, the ultimate agentic AI developer experience. \ Download it and try it out for free! https://piebald.ai/

_{Scroll down for Claude Code LSPs. :point_down:}

Claude Code LSPs

This repository contains a Claude Code marketplace with plugins that offer LSP servers for TypeScript, Rust, Python, Go, Java, Kotlin, Scala, C/C++, PHP, Ruby, C#, PowerShell, HTML/CSS, LaTeX, Julia, Vue, Svelte, OCaml, BSL (1C:Enterprise), Ada, Dart, Solidity, Elixir, Bash, and Markdown/mdbase. LSP servers provide powerful and familiar code intelligence features to IDEs, and now Claude Code directly.

Claude Code officially supports LSP. In 2.0.74 they officially added it to the changelog. Previously, the new LSP builtin tool had to be enabled manually via $ENABLE_LSP_TOOL=1.

This marketplace currently targets Claude Code 2.1.50+ (latest release: 2.1.52) to use modern LSP configuration fields like startupTimeout.

Claude can use the LSP tool to - Go to the definition for symbols (goToDefinition) - Go to the implementation for symbols (goToImplementation) - Hover over symbols (hover) - List all the symbols in a file (documentSymbol) - Find all references to a symbol (findReferences) - Search for symbols across the workspace (workspaceSymbol) - Get the call hierarchy for a given function (prepareCallHierarchy) - Find all functions that call a given function (incomingCalls) - Find all functions/methods called by a given function (outgoingCalls)

Patching Claude Code

Run npx tweakcc --apply. tweakcc automatically detects your Claude Code installation (npm or native) and applies the necessary patches. It will automatically patch your Claude Code installation to make CC's builtin LSP support usable. (It also does a bunch of other things like let you customize all the system prompt parts, create new CC themes, change the thinking verbs, and a lot more.)

Installing the plugins

Install them the usual way. First make CC aware of the marketplace: 1. Run claude 2. /plugin marketplace add Piebald-AI/claude-code-lsps

Then enable the plugins of your choice: 1. Run claude 2. Type /plugins 3. Tab to Marketplaces 4. Enter the claude-code-lsps marketplace and choose Browse plugins 5. Select the plugins you'd like with the spacebar (e.g. TypeScript, Rust) 6. Press "i" to install them 7. Restart Claude Code

LSP definition workflow (for contributors)

• .lsp.json files are the canonical source of LSP configuration.
• .claude-plugin/marketplace.json lspServers entries are generated from .lsp.json.
• Do not hand-edit generated lspServers blocks.
• sync-lsp-to-marketplace only updates plugins that already exist in marketplace plugins[]. Add a marketplace entry first when introducing a new plugin directory.
• validate-lsp-definitions will fail if a plugin directory exists but is not referenced in marketplace plugins[].

Run this workflow after any LSP config change:

node scripts/validate-all.mjs

validate-all runs: - sync-lsp-to-marketplace.mjs - validate-lsp-definitions.mjs - validate-runtime-marketplace.mjs

Optional: node scripts/validate-all.mjs --skip-runtime to skip Claude runtime validation.

Language-specific setup instructions

You need to install various components in order for the plugins to use them:

Rust (rust-analyzer)

Uses rust-analyzer, the official modern Rust Language Server and the same one used by the official VS Code extension. If you have rustup, installing rust-analyzer is easy:

rustup component add rust-analyzer

The rust-analyzer executable needs to be in your PATH.

JavaScript/TypeScript (vtsls)

Install vtsls and typescript packages globally:

# npm
npm install -g @vtsls/language-server typescript

# pnpm
pnpm install -g @vtsls/language-server typescript

# bun
bun install -g @vtsls/language-server typescript

Make sure the vtsls executable is in your PATH.

Python (pyright)

Install pyright for its speed and excellent type checking:

# npm
npm install -g pyright

# pnpm
pnpm install -g pyright

# bun
bun install -g pyright

Python (ty)

Install ty, Astral's extremely fast Python type checker:

# uv (recommended)
uv tool install ty

# pip
pip install ty

Make sure the ty executable is in your PATH. ty auto-detects pyproject.toml for project configuration.

Go (gopls)

Install gopls, the official Go language server:

go install golang.org/x/tools/gopls@latest

Make sure your Go bin directory is in your PATH (usually ~/go/bin).

Java (jdtls)

Install Eclipse JDT Language Server (jdtls). Requires Java 21+ runtime:

# Download from official sources
# Latest snapshot:
curl -LO http://download.eclipse.org/jdtls/snapshots/jdt-language-server-latest.tar.gz
mkdir -p ~/jdtls
tar -xzf jdt-language-server-latest.tar.gz -C ~/jdtls

# Or install via package manager (varies by OS)
# macOS with Homebrew:
brew install jdtls

Set JAVA_HOME environment variable to Java 21+ installation.

Kotlin (kotlin-lsp)

Requires Java 17+. Install kotlin-lsp:

# macOS with Homebrew
brew install JetBrains/utils/kotlin-lsp

For manual installation, download from releases and add to PATH.

Note: Currently supports JVM-only Kotlin Gradle projects.

Scala (metals)

Requires Java 11 or 17. Install Metals using Coursier:

# Install Coursier (if not already installed)
# macOS with Homebrew:
brew install coursier/formulas/coursier

# Then bootstrap Metals:
coursier bootstrap org.scalameta:metals_2.13:1.6.5 -o metals -f
# Move the generated `metals` binary to a directory on your PATH

# Or with recommended JVM options:
coursier bootstrap \
  --java-opt -XX:+UseG1GC \
  --java-opt -XX:+UseStringDeduplication \
  --java-opt -Xss4m \
  --java-opt -Xms100m \
  org.scalameta:metals_2.13:1.6.5 -o metals -f

Ensure metals is on your PATH and JAVA_HOME points to a Java 11 or 17 installation.

Supported build tools: sbt, Gradle, Maven, Mill (via Bloop/BSP).

C/C++ (clangd)

Install clangd, the official LLVM-based language server:

# macOS
brew install llvm

# Ubuntu/Debian
sudo apt-get install clangd

# Arch Linux
sudo pacman -S clang

# Or download from LLVM releases
# https://github.com/clangd/clangd/releases

PHP (phpactor)

Install Phpactor:

# Using composer (recommended)
composer global require --dev phpactor/phpactor

# Or using package manager
# macOS with Homebrew:
brew install phpactor/tap/phpactor

Ensure ~/.composer/vendor/bin (or ~/.config/composer/vendor/bin on some systems) is in your PATH.

PHP — php-lsp (php-lsp)

Install php-lsp (requires Rust):

cargo install php-lsp

The php-lsp executable needs to be in your PATH.

Ruby (ruby-lsp)

Install ruby-lsp:

gem install ruby-lsp

Perl (perl-lsp)

Install perl-lsp. Download a prebuilt binary for your platform (macOS, Linux, Windows) from the releases page and put perl-lsp on your PATH, or build from source with a Rust toolchain:

cargo install perl-lsp

Provides type inference without annotations, cross-file navigation, and framework intelligence for Moo/Moose, Mojolicious, and DBIx::Class. See the project page for details.

C# (omnisharp)

Install OmniSharp (requires .NET SDK):

# macOS with Homebrew:
brew install omnisharp/omnisharp-roslyn/omnisharp-mono

# Or download from releases:
# https://github.com/OmniSharp/omnisharp-roslyn/releases

# Extract and add to PATH, or use the install script:
# Linux/macOS:
curl -L https://github.com/OmniSharp/omnisharp-roslyn/releases/latest/download/omnisharp-linux-x64-net6.0.tar.gz | tar xz -C ~/.local/bin

# Ensure the OmniSharp executable is in your PATH

PowerShell (powershell-editor-services)

Requires PowerShell 7+ (pwsh) installed and available in PATH.

# Windows (winget)
winget install Microsoft.PowerShell

# macOS
brew install powershell/tap/powershell

# Ubuntu/Debian
# See: https://learn.microsoft.com/en-us/powershell/scripting/install/install-ubuntu

The PowerShellEditorServices module is not installed automatically at runtime. Install it manually:

Install-Module -Name PowerShellEditorServices -Scope CurrentUser

HTML/CSS/ESLint (vscode-langservers)

Install @zed-industries/vscode-langservers-extracted for HTML, CSS, and ESLint:

# npm
npm install -g @zed-industries/vscode-langservers-extracted

# pnpm
pnpm install -g @zed-industries/vscode-langservers-extracted

# bun
bun install -g @zed-industries/vscode-langservers-extracted

This provides vscode-html-language-server, vscode-css-language-server, and vscode-eslint-language-server executables.

The ESLint language server requires ESLint to be installed in your project:

npm install --save-dev eslint

LaTeX (texlab)

Install texlab, a cross-platform LSP implementation for LaTeX:

# Cargo
cargo install --locked texlab

# macOS
brew install texlab

# Arch Linux
pacman -S texlab

# Windows
scoop install texlab
# or
choco install texlab

The texlab executable needs to be in your PATH. Supports .tex, .bib, .cls, and .sty files.

Julia (julia-lsp)

Install LanguageServer.jl in Julia:

using Pkg
Pkg.add("LanguageServer")
Pkg.add("SymbolServer")

Make sure julia is in your PATH. The language server will automatically detect your Julia project environment based on Project.toml.

Note: The language server may take some time to start on first use while it precompiles. Subsequent starts will be faster, especially with Julia 1.9+.

Vue (vue-volar)

Install @vue/language-server (v2.x) globally for Vue.js Single File Component support:

# npm
npm install -g @vue/language-server@2

# pnpm
pnpm install -g @vue/language-server@2

# bun
bun install -g @vue/language-server@2

Important: Version 2.x is required. Version 3.x removed the internal TypeScript communication layer and requires the LSP client to implement custom request forwarding (tsserver/request → tsserver/response) between Vue and TypeScript language servers. Claude Code's simple LSP integration does not support this mechanism. See v3 upgrade guide for details.

The plugin launcher scans PATH and picks the newest compatible vue-language-server 2.x.x binary (ignoring 3.x.x).

Important: For full functionality, TypeScript must be installed in your project:

npm install --save-dev typescript

The language server uses the project's node_modules/typescript/lib for type checking. This enables: - Template expression type-checking - Component prop validation - Slot type inference - CSS/SCSS intellisense in <style> blocks - Go-to-definition across <template>, <script>, <style>

Note: This plugin complements the existing vtsls plugin for TypeScript, providing full Vue + TS coverage.

Svelte (svelte-lsp)

Install svelte-language-server globally for Svelte Single File Component support:

# npm
npm install -g svelte-language-server

# bun
bun add -g svelte-language-server

# pnpm
pnpm add -g svelte-language-server

This provides: - Diagnostics for .svelte files - Hover info and completions - Go-to-definition for components and