Sandbox
@boostvolt/claude-code-lsps

Claude Code LSP plugins for many languages

This repository packages language server plugins for Claude Code so the assistant can use definition lookup, references, hover, symbols, implementation search, and call hierarchy. It also enables automatic diagnostics for supported files. Each language has its own plugin directory with the LSP config and hook files needed to start and manage the server.

181 stars18 forksShellUpdated 3mo ago
Who it's for

Builders who use Claude Code and want their agent to understand and inspect code in many languages.

What it delivers

You can get IDE-like navigation and diagnostics inside Claude Code instead of re-explaining code structure by hand.

What it does

Language server commands

Claude Code gets built-in LSP actions like go to definition, find references, hover, document symbols, workspace symbols, implementation lookup, and call hierarchy.

Automatic diagnostics

Supported servers run in the background and report errors and warnings as you work.

Many language plugins

The collection covers Bash, C/C++, C#, Clojure, Dart, Elixir, Gleam, Go, Java, Kotlin, Lua, Nix, OCaml, PHP, Python, Ruby, Rust, Swift, Terraform, TypeScript/JavaScript, YAML, and Zig.

Plugin install flow

You can add the marketplace once, then install individual language plugins from Claude Code with `/plugin install ...`.

Per-language LSP setup

Each plugin uses its own `.lsp.json` file and optional hooks to start the right server and handle setup.

How to get it

  1. 1Run
    claude
    /plugin marketplace add boostvolt/claude-code-lsps
  2. 2Or browse and install interactively
    /plugin
  3. 3Each plugin will attempt to auto-install its LSP server on first use. If auto-install…
    brew install bash-language-server
  4. 4Or via npm
    npm install -g bash-language-server
  5. 5Run
    brew install llvm
  6. 6Or via Xcode Command Line Tools
    xcode-select --install

README

Claude Code LSPs

A collection of Language Server Protocol (LSP) plugins for Claude Code.

LSP Demo

What is LSP Integration?

[!NOTE] LSP Integration: If you're on v2.0.69 through v2.0.x, LSP integration is broken due to a race condition (#14803, #13952). This has been fixed in v2.1.0+. Please upgrade to the latest version.

The Language Server Protocol provides IDE-like intelligence to Claude Code. On startup, Claude Code automatically starts LSP servers from installed plugins and exposes them to Claude in two ways:

LSP Tool - A builtin tool with 9 operations mapping directly to LSP commands:

OperationDescription
goToDefinitionFind where a symbol is defined
findReferencesFind all references to a symbol
hoverGet hover info (docs, type info) for a symbol
documentSymbolGet all symbols (functions, classes, variables) in a document
workspaceSymbolSearch for symbols across the entire workspace
goToImplementationFind implementations of an interface/abstract method
prepareCallHierarchyGet call hierarchy item at a position
incomingCallsFind all functions/methods that call the function at a position
outgoingCallsFind all functions/methods called by the function at a position

Automatic Diagnostics - Real-time error and warning detection similar to the VS Code integration, but operating independently. These diagnostics tend to be faster and more comprehensive than the VS Code equivalent.

Available Plugins

PluginLanguageExtensionsLSP
bash-language-serverBash/Shell.sh .bash .zsh .kshbash-language-server
clangdC/C++/Objective-C.c .h .cpp .hpp .cc .cxx .hxx .m .mmclangd
clojure-lspClojure.clj .cljs .cljc .ednclojure-lsp
dart-analyzerDart/Flutter.dartDart SDK
elixir-lsElixir.ex .exselixir-ls
gleamGleam.gleamgleam
goplsGo.gogopls
intelephensePHP.php .phtmlIntelephense
jdtlsJava.javajdtls
kotlin-lspKotlin.kt .ktskotlin-lsp
lua-language-serverLua.lualua-language-server
nixdNix.nixnixd
ocaml-lspOCaml.ml .mliocaml-lsp
omnisharpC#.cs .csxOmniSharp
pyrightPython.py .pyipyright
rust-analyzerRust.rsrust-analyzer
solargraphRuby.rb .rake .gemspecSolargraph
sourcekit-lspSwift.swiftsourcekit-lsp
terraform-lsTerraform.tf .tfvarsterraform-ls
vtslsTypeScript/JavaScript.ts .tsx .js .jsx .mjs .cjsvtsls
yaml-language-serverYAML.yaml .ymlyaml-language-server
zlsZig.zig .zonzls

Getting Started

1. Add the Marketplace

claude
/plugin marketplace add boostvolt/claude-code-lsps

2. Install Plugins

Install individual plugins:

/plugin install bash-language-server@claude-code-lsps
/plugin install clangd@claude-code-lsps
/plugin install clojure-lsp@claude-code-lsps
/plugin install dart-analyzer@claude-code-lsps
/plugin install elixir-ls@claude-code-lsps
/plugin install gleam@claude-code-lsps
/plugin install gopls@claude-code-lsps
/plugin install intelephense@claude-code-lsps
/plugin install jdtls@claude-code-lsps
/plugin install kotlin-lsp@claude-code-lsps
/plugin install lua-language-server@claude-code-lsps
/plugin install nixd@claude-code-lsps
/plugin install ocaml-lsp@claude-code-lsps
/plugin install omnisharp@claude-code-lsps
/plugin install pyright@claude-code-lsps
/plugin install rust-analyzer@claude-code-lsps
/plugin install solargraph@claude-code-lsps
/plugin install sourcekit-lsp@claude-code-lsps
/plugin install terraform-ls@claude-code-lsps
/plugin install vtsls@claude-code-lsps
/plugin install yaml-language-server@claude-code-lsps
/plugin install zls@claude-code-lsps

Or browse and install interactively:

/plugin

Manual LSP Installation

Each plugin will attempt to auto-install its LSP server on first use. If auto-install fails, use the manual instructions below.

Bash/Shell (bash-language-server)
brew install bash-language-server

Or via npm:

npm install -g bash-language-server
C/C++/Objective-C (clangd)
brew install llvm

Or via Xcode Command Line Tools:

xcode-select --install

Supports C, C++, Objective-C (.m), and Objective-C++ (.mm) files.

C# (omnisharp)
brew install omnisharp/omnisharp-roslyn/omnisharp-mono

Or via dotnet:

dotnet tool install -g csharp-ls
Clojure (clojure-lsp)
brew install clojure-lsp

Or download from GitHub releases.

Dart/Flutter (dart-analyzer)

Install Dart SDK:

brew tap dart-lang/dart
brew install dart

Or install Flutter (includes Dart):

# See https://docs.flutter.dev/get-started/install

Ensure dart is in your PATH.

Elixir (elixir-ls)
brew install elixir-ls

Requires Elixir to be installed:

brew install elixir
Gleam (gleam)
brew install gleam

Or download from GitHub releases.

Go (gopls)
go install golang.org/x/tools/gopls@latest

Ensure ~/go/bin is in your PATH.

Java (jdtls)
brew install jdtls

Or download manually from Eclipse JDT Language Server.

Requires Java 21+ runtime.

Kotlin (kotlin-lsp)
brew install JetBrains/utils/kotlin-lsp

Or download from GitHub releases.

Requires Java 17+.

Lua (lua-language-server)
brew install lua-language-server

Or download from GitHub releases.

Nix (nixd)
nix profile install nixpkgs#nixd

Requires Nix to be installed. See nixos.org.

OCaml (ocaml-lsp)
opam install ocaml-lsp-server

Requires opam to be installed:

brew install opam
opam init
PHP (intelephense)
npm install -g intelephense
Python (pyright)
pip install pyright
Ruby (solargraph)
gem install solargraph
Rust (rust-analyzer)
brew install rust-analyzer

Or via rustup:

rustup component add rust-analyzer
Swift (sourcekit-lsp)

sourcekit-lsp is bundled with Xcode. Install Xcode from the App Store:

# Verify installation
xcrun --find sourcekit-lsp

Or install a Swift toolchain from swift.org/install.

Terraform (terraform-ls)
brew install terraform-ls

Or download from GitHub releases.

TypeScript/JavaScript (vtsls)
npm install -g @vtsls/language-server typescript
YAML (yaml-language-server)
brew install yaml-language-server

Or via npm:

npm install -g yaml-language-server
Zig (zls)
brew install zls

Requires Zig to be installed. Download from ziglang.org.


Creating Your Own Plugin

Plugin Structure
my-lsp/
├── .claude-plugin/
│   └── plugin.json
├── .lsp.json
└── hooks/
    ├── hooks.json
    └── check-my-lsp.sh
.lsp.json Schema

The .lsp.json file configures the language server:

{
  "language-id": {
    "command": "lsp-server-command",
    "extensionToLanguage": {
      ".ext": "language-id"
    }
  }
}

Required Fields

FieldTypeDescription
commandstringCommand to start the LSP server
extensionToLanguageobjectMaps file extensions to language IDs

Optional Fields

FieldTypeDescription
argsstring[]Arguments passed to the command
transportstringCommunication method: "stdio" (default) or "socket"
envobjectEnvironment variables to set when starting the server
initializationOptionsobjectOptions passed during LSP initialization
settingsobjectServer-specific settings via workspace/didChangeConfiguration
workspaceFolderstringWorkspace folder path for the server
startupTimeoutnumberMax time to wait for server startup (milliseconds)
shutdownTimeoutnumberMax time to wait for graceful shutdown (milliseconds)
restartOnCrashbooleanWhether to automatically restart the server if it crashes
maxRestartsnumberMax restart attempts before giving up (default: 3)
Example: gopls

.lsp.json:

{
  "go": {
    "command": "gopls",
    "extensionToLanguage": {
      ".go": "go"
    }
  }
}

.claude-plugin/plugin.json:

{
  "name": "gopls",
  "description": "Go language server",
  "version": "1.0.0",
  "author": {
    "name": "Your Name"
  },
  "license": "MIT",
  "repository": "https://github.com/boostvolt/claude-code-lsps"
}

hooks/hooks.json (optional auto-install):

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/check-gopls.sh",
            "timeout": 30
          }
        ]
      }
    ]
  }
}

License

MIT

Files in the repo

Repository payload28 top-level entries
  • .claude-plugin
  • .github
  • assets
  • bash-language-server
  • clangd
  • clojure-lsp
  • dart-analyzer
  • elixir-ls
  • gleam
  • gopls
  • intelephense
  • jdtls
  • kotlin-lsp
  • lua-language-server
  • nixd
  • ocaml-lsp
  • omnisharp
  • pyright
  • rust-analyzer
  • solargraph
  • sourcekit-lsp
  • terraform-ls
  • vtsls
  • yaml-language-server
  • zls
  • CLAUDE.md
  • LICENSE.md
  • README.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More plugins

Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.

138k
1 add

Graphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.

82k
code-yeongyu/
oh-my-openagent

OmO: Just type "mass ulw" keyword with your prompt. Now you are the master of graph engineering.

69k

Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More

94k

Opinionated Oxlint rules for rejecting low-evidence TypeScript and JavaScript patterns

4.3k