pyright

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:

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

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.

<details> <summary><strong>Bash/Shell (bash-language-server)</strong></summary>

brew install bash-language-server

Or via npm:

npm install -g bash-language-server

</details>

<details> <summary><strong>C/C++/Objective-C (clangd)</strong></summary>

brew install llvm

Or via Xcode Command Line Tools:

xcode-select --install

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

</details>

<details> <summary><strong>C# (omnisharp)</strong></summary>

brew install omnisharp/omnisharp-roslyn/omnisharp-mono

Or via dotnet:

dotnet tool install -g csharp-ls

</details>

<details> <summary><strong>Clojure (clojure-lsp)</strong></summary>

brew install clojure-lsp

Or download from GitHub releases.

</details>

<details> <summary><strong>Dart/Flutter (dart-analyzer)</strong></summary>

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.

</details>

<details> <summary><strong>Elixir (elixir-ls)</strong></summary>

brew install elixir-ls

Requires Elixir to be installed:

brew install elixir

</details>

<details> <summary><strong>Gleam (gleam)</strong></summary>

brew install gleam

Or download from GitHub releases.

</details>

<details> <summary><strong>Go (gopls)</strong></summary>

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

Ensure ~/go/bin is in your PATH.

</details>

<details> <summary><strong>Java (jdtls)</strong></summary>

brew install jdtls

Or download manually from Eclipse JDT Language Server.

Requires Java 21+ runtime.

</details>

<details> <summary><strong>Kotlin (kotlin-lsp)</strong></summary>

brew install JetBrains/utils/kotlin-lsp

Or download from GitHub releases.

Requires Java 17+.

</details>

<details> <summary><strong>Lua (lua-language-server)</strong></summary>

brew install lua-language-server

Or download from GitHub releases.

</details>

<details> <summary><strong>Nix (nixd)</strong></summary>

nix profile install nixpkgs#nixd

Requires Nix to be installed. See nixos.org.

</details>

<details> <summary><strong>OCaml (ocaml-lsp)</strong></summary>

opam install ocaml-lsp-server

Requires opam to be installed:

brew install opam
opam init

</details>

<details> <summary><strong>PHP (intelephense)</strong></summary>

npm install -g intelephense

</details>

<details> <summary><strong>Python (pyright)</strong></summary>

pip install pyright

</details>

<details> <summary><strong>Ruby (solargraph)</strong></summary>

gem install solargraph

</details>

<details> <summary><strong>Rust (rust-analyzer)</strong></summary>

brew install rust-analyzer

Or via rustup:

rustup component add rust-analyzer

</details>

<details> <summary><strong>Swift (sourcekit-lsp)</strong></summary>

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.

</details>

<details> <summary><strong>Terraform (terraform-ls)</strong></summary>

brew install terraform-ls

Or download from GitHub releases.

</details>

<details> <summary><strong>TypeScript/JavaScript (vtsls)</strong></summary>

npm install -g @vtsls/language-server typescript

</details>

<details> <summary><strong>YAML (yaml-language-server)</strong></summary>

brew install yaml-language-server

Or via npm:

npm install -g yaml-language-server

</details>

<details> <summary><strong>Zig (zls)</strong></summary>

brew install zls

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

</details>

Creating Your Own Plugin

<details> <summary><strong>Plugin Structure</strong></summary>

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

</details>

<details> <summary><strong>.lsp.json Schema</strong></summary>

The .lsp.json file configures the language server:

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

Required Fields

Optional Fields

</details>

<details> <summary><strong>Example: gopls</strong></summary>

.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
          }
        ]
      }
    ]
  }
}

</details>

License

MIT