AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

lsp-setup

Enable code intelligence (go-to-definition, find-references, hover, type info) for any programming language by installing and configuring an LSP server for Copilot CLI. Detects the OS, installs the right server, and generates the JSON configuration (user-level or repo-level). Use when you need deeper code understanding and no LSP server is configured, or when the user asks to set up, install, or configure an LSP server.

Original source
github
License
MIT
Pinned revision
5269f7ea2d6c3a9bfda5ed878b6726cf509121fd

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

Ask your assistant

Use Agentic Memory skills to read github--lsp-setup at revision 5269f7ea2d6c3a9bfda5ed878b6726cf509121fd, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 3

references/lsp-servers.md

Known LSP Servers for Copilot CLI

Reference data for the lsp-setup skill. Each section contains install commands per OS and a ready-to-use config snippet.

Config snippet format: Each snippet below shows the object to insert as a value under the top-level lspServers key. A complete config file looks like: { "lspServers": { <snippet here> } }. When adding multiple languages, merge their snippets as sibling keys under lspServers.


TypeScript / JavaScript

Server: typescript-language-server

Install

| OS | Command | |---------|-------------------------------------------------------| | Any | npm install -g typescript typescript-language-server |

Config snippet

{
  "typescript": {
    "command": "typescript-language-server",
    "args": ["--stdio"],
    "fileExtensions": {
      ".ts": "typescript",
      ".tsx": "typescriptreact",
      ".js": "javascript",
      ".jsx": "javascriptreact"
    }
  }
}

Java

Server: Eclipse JDT Language Server (jdtls)

jdtls itself needs a recent JDK (21 or newer for current releases) on JAVA_HOME or $PATH. This is independent of the project's target JDK: a Java 17 project can be analyzed by jdtls running on JDK 21+, as long as a JDK matching the project's release/toolchain is installed. Java LSP is optional; it is not required for compiling, testing or runtime diagnostics.

Install

| OS | Command | |---------|-----------------------------------| | macOS | brew install jdtls | | Linux | brew install jdtls (Homebrew on Linux), a distro package if available, or download a release from https://download.eclipse.org/jdtls/milestones/, extract it, and put its bin/ on PATH | | Windows | Download from https://download.eclipse.org/jdtls/milestones/, extract, and add bin\ to PATH (or use WSL with the Linux steps) |

Windows note: the bin/jdtls wrapper is a Python 3.9+ script with no .exe/.cmd extension, so Windows cannot launch jdtls from PATH directly. Either use WSL, or configure the LSP command as python with the full path to the extensionless bin\jdtls launcher as the first argument followed by the other args (jdtls.py next to it is only the implementation module; running it directly does nothing), or launch the server JAR directly as described in the jdtls README.

The wrapper script (the jdtls launcher, which requires Python 3 and imports jdtls.py) speaks stdio by default, so no --stdio argument is needed.

Config snippet

Repo-level .github/lsp.json (no absolute paths; the data dir is relative to the project):

{
  "lspServers": {
    "java": {
      "command": "jdtls",
      "args": [
        "--jvm-arg=-Xmx2G",
        "-data", ".jdtls-workspace"
      ],
      "fileExtensions": {
        ".java": "java"
      }
    }
  }
}

Add .jdtls-workspace/ to .gitignore. Verified with Homebrew jdtls 1.61.0 on macOS: --jvm-arg=-Xmx2G -data .jdtls-workspace are accepted, the server answers initialize over stdio and documentSymbol on a Quarkus project (Copilot CLI 1.0.95 copilot lsp list loads this .github/lsp.json shape, which also matches the GitHub docs field table: command, args, fileExtensions required, optional env, rootUri, initializationOptions, requestTimeoutMs, initializationTimeoutMs; a live lsp tool call through it was not exercised). Run jdtls --help to confirm that your wrapper version supports --jvm-arg and -data; if not, drop those flags and use the plain "args": [] form.

Maven (pom.xml) and Gradle (build.gradle[.kts]) projects are imported automatically. See java-jdtls.md for project import, troubleshooting, performance, Lombok/annotation processing, and what each lsp operation provides for Java.


Python

Server: pyright

Install

| OS | Command | |---------|----------------------------| | Any | npm install -g pyright | | Any | pip install pyright |

Config snippet

{
  "python": {
    "command": "pyright-langserver",
    "args": ["--stdio"],
    "fileExtensions": {
      ".py": "python"
    }
  }
}

Go

Server: gopls

Install

| OS | Command | |---------|--------------------------------------------| | Any | go install golang.org/x/tools/gopls@latest | | macOS | brew install gopls |

Config snippet

{
  "go": {
    "command": "gopls",
    "args": ["serve"],
    "fileExtensions": {
      ".go": "go"
    }
  }
}

Rust

Server: rust-analyzer

Install

| OS | Command | |---------|--------------------------------| | Any | rustup component add rust-analyzer | | macOS | brew install rust-analyzer | | Linux | Distribution package or rustup | | Windows | rustup component add rust-analyzer or download from GitHub releases |

Config snippet

{
  "rust": {
    "command": "rust-analyzer",
    "args": [],
    "fileExtensions": {
      ".rs": "rust"
    }
  }
}

C / C++

Server: clangd

Install

| OS | Command | |---------|----------------------------------------| | macOS | brew install llvm (clangd included) or Xcode command line tools | | Linux | apt install clangd / dnf install clang-tools-extra | | Windows | Download LLVM from https://releases.llvm.org/ |

Config snippet

{
  "cpp": {
    "command": "clangd",
    "args": ["--background-index"],
    "fileExtensions": {
      ".c": "c",
      ".h": "c",
      ".cpp": "cpp",
      ".cxx": "cpp",
      ".cc": "cpp",
      ".hpp": "cpp",
      ".hxx": "cpp"
    }
  }
}

C# (.NET)

Server: Roslyn Language Server (via dotnet dnx)

Install

| OS | Command | |---------|----------------------------------------------------------------| | Any | Requires the .NET SDK installed |

Config snippet

{
  "csharp": {
    "command": "dotnet",
    "args": ["dnx", "roslyn-language-server", "--yes", "--prerelease", "--", "--stdio", "--autoLoadProjects"],
    "fileExtensions": {
      ".cs": "csharp"
    }
  }
}

Ruby

Server: solargraph

Install

| OS | Command | |---------|---------------------------| | Any | gem install solargraph |

Config snippet

{
  "ruby": {
    "command": "solargraph",
    "args": ["stdio"],
    "fileExtensions": {
      ".rb": "ruby",
      ".rake": "ruby",
      ".gemspec": "ruby"
    }
  }
}

PHP

Server: intelephense

Install

| OS | Command | |---------|--------------------------------------------| | Any | npm install -g intelephense |

Config snippet

{
  "php": {
    "command": "intelephense",
    "args": ["--stdio"],
    "fileExtensions": {
      ".php": "php"
    }
  }
}

Kotlin

Server: kotlin-language-server

Install

| OS | Command | |---------|---------------------------------------------------| | macOS | brew install kotlin-language-server | | Any | Download from GitHub releases and add to PATH |

Config snippet

{
  "kotlin": {
    "command": "kotlin-language-server",
    "args": [],
    "fileExtensions": {
      ".kt": "kotlin",
      ".kts": "kotlin"
    }
  }
}

Swift

Server: sourcekit-lsp (bundled with Swift toolchain)

Install

| OS | Command | |---------|----------------------------------------------------------------| | macOS | Included with Xcode; binary at xcrun sourcekit-lsp | | Linux | Included with Swift toolchain; install from https://swift.org | | Windows | Included with Swift toolchain; install from https://swift.org |

Config snippet

{
  "swift": {
    "command": "sourcekit-lsp",
    "args": [],
    "fileExtensions": {
      ".swift": "swift"
    }
  }
}

On macOS you may need to use the full path: /usr/bin/sourcekit-lsp or set command to xcrun with args: ["sourcekit-lsp"].


Lua

Server: lua-language-server

Install

| OS | Command | |---------|--------------------------------------| | macOS | brew install lua-language-server | | Linux | Download from GitHub releases | | Windows | Download from GitHub releases |

Config snippet

{
  "lua": {
    "command": "lua-language-server",
    "args": [],
    "fileExtensions": {
      ".lua": "lua"
    }
  }
}

YAML

Server: yaml-language-server

Install

| OS | Command | |---------|----------------------------------------------| | Any | npm install -g yaml-language-server |

Config snippet

{
  "yaml": {
    "command": "yaml-language-server",
    "args": ["--stdio"],
    "fileExtensions": {
      ".yaml": "yaml",
      ".yml": "yaml"
    }
  }
}

Bash / Shell

Server: bash-language-server

Install

| OS | Command | |---------|-----------------------------------------------| | Any | npm install -g bash-language-server |

Config snippet

{
  "bash": {
    "command": "bash-language-server",
    "args": ["start"],
    "fileExtensions": {
      ".sh": "shellscript",
      ".bash": "shellscript",
      ".zsh": "shellscript"
    }
  }
}