Skip to content

Installation

Prerequisites

agent-lsp is a single binary with no runtime dependencies. You need:

  • A language server for your language (e.g., gopls for Go, typescript-language-server for TypeScript, pyright for Python). Run agent-lsp doctor after installing to check which servers are available on your PATH.
  • An MCP client to connect to agent-lsp: Claude Code, Cursor, Continue, or any tool that supports the Model Context Protocol.

For specific install methods below, you also need the corresponding package manager: Homebrew, npm (Node.js 18+), Go 1.21+, or Docker.

curl -fsSL https://raw.githubusercontent.com/blackwell-systems/agent-lsp/main/install.sh | sh

Homebrew (macOS / Linux)

brew install blackwell-systems/tap/agent-lsp

npm

npm install -g @blackwell-systems/agent-lsp

Go install

go install github.com/blackwell-systems/agent-lsp/cmd/agent-lsp@latest

Docker

# Go
docker run --rm -i -v /your/project:/workspace ghcr.io/blackwell-systems/agent-lsp:go go:gopls

# TypeScript
docker run --rm -i -v /your/project:/workspace ghcr.io/blackwell-systems/agent-lsp:typescript typescript:typescript-language-server,--stdio

# Python
docker run --rm -i -v /your/project:/workspace ghcr.io/blackwell-systems/agent-lsp:python python:pyright-langserver,--stdio

See distribution for the full Docker tag list and HTTP mode setup.

Windows

PowerShell (no admin required)

iwr -useb https://raw.githubusercontent.com/blackwell-systems/agent-lsp/main/install.ps1 | iex

Scoop

scoop bucket add blackwell-systems https://github.com/blackwell-systems/agent-lsp
scoop install blackwell-systems/agent-lsp

Winget

winget install BlackwellSystems.agent-lsp

Verify your installation

agent-lsp doctor

This probes each configured language server and reports capabilities. Fix any failures before proceeding. See language support for install commands and server-specific notes.