Quick Start¶

After installing agent-lsp, follow these steps to get up and running.

1. Install language servers¶

Install the servers for your stack:

Language	Server	Install
TypeScript / JavaScript	`typescript-language-server`	`npm i -g typescript-language-server typescript`
Python	`pyright-langserver`	`npm i -g pyright`
Go	`gopls`	`go install golang.org/x/tools/gopls@latest`
Rust	`rust-analyzer`	`rustup component add rust-analyzer`
C / C++	`clangd`	`apt install clangd` / `brew install llvm`
Ruby	`solargraph`	`gem install solargraph`

Full list of 30 supported languages in language support.

2. Configure your AI tool¶

agent-lsp init

This detects language servers on your PATH, asks which AI tool you use, and writes the correct MCP config. For CI or scripted use: agent-lsp init --non-interactive.

The generated config looks like:

{
  "mcpServers": {
    "lsp": {
      "type": "stdio",
      "command": "agent-lsp",
      "args": [
        "go:gopls",
        "typescript:typescript-language-server,--stdio",
        "python:pyright-langserver,--stdio"
      ]
    }
  }
}

Each arg is language:server-binary (comma-separate server args).

3. Install skills¶

git clone https://github.com/blackwell-systems/agent-lsp.git /tmp/agent-lsp-skills
cd /tmp/agent-lsp-skills/skills && ./install.sh --copy

Skills are prompt files copied into your AI tool's configuration -- --copy means the clone can be safely deleted afterward.

Skills are multi-tool workflows that encode reliable procedures -- blast-radius check before edit, speculative preview before write, test run after change. See the skills reference for the full list.

4. Start working¶

Your AI agent calls tools automatically. The first call initializes the workspace:

start_lsp(root_dir="/your/project")

This is what the agent does, not something you type. Then use any of the 50 tools. The session stays warm; no restart needed when switching files.

Verify setup¶

At any point, run:

agent-lsp doctor

This probes each configured language server and reports capabilities. Fix any failures before proceeding.