Imported from tiankong0101-byte/skills-registry (skills/oh-my-claudecode/src/tools/lsp/AGENTS.md). Install upstream with npx skills add tiankong0101-byte/skills-registry --skill lsp. Copyright stays with the author.

lsp

Language Server Protocol (LSP) client implementation providing IDE-like code intelligence.

Purpose

This directory implements the LSP client that enables agents to:

• Connect to language servers (TypeScript, Python, Rust, Go, etc.)
• Get type information, documentation, and signatures
• Find definitions, references, and symbols
• Perform refactoring operations (rename, code actions)
• Collect diagnostics (errors, warnings)

Key Files

For AI Agents

Working In This Directory

LSP Client Architecture

┌─────────────────┐     JSON-RPC 2.0      ┌──────────────────┐
│   LspClient     │◄────────────────────►│ Language Server  │
│                 │       stdio           │ (tsserver, etc.) │
│ - connect()     │                       │                  │
│ - hover()       │                       │                  │
│ - definition()  │                       │                  │
│ - references()  │                       │                  │
│ - diagnostics() │                       │                  │
└─────────────────┘                       └──────────────────┘

Client Manager

lspClientManager is a singleton that pools connections:

// Get client for a file (auto-selects appropriate server)
const client = await lspClientManager.getClientForFile('src/index.ts');

// Client is reused for same workspace/server combo
const key = `${workspaceRoot}:${serverConfig.command}`;

Server Configuration

Each server in LSP_SERVERS has:

interface LspServerConfig {
  name: string;           // Human-readable name
  command: string;        // Executable command
  args: string[];         // Command arguments
  extensions: string[];   // File extensions handled
  installHint: string;    // Installation instructions
}

Common Patterns

Request/Response:

// All requests use JSON-RPC 2.0 format
const request = {
  jsonrpc: '2.0',
  id: this.requestId++,
  method: 'textDocument/hover',
  params: { textDocument: { uri }, position: { line, character } }
};

// Wrapped in Content-Length header
const message = `Content-Length: ${content.length}\r\n\r\n${content}`;

Notification handling:

// Server pushes diagnostics via notifications
if (notification.method === 'textDocument/publishDiagnostics') {
  this.diagnostics.set(params.uri, params.diagnostics);
}

Testing Requirements

LSP tests require language servers to be installed:

# Install TypeScript server
npm i -g typescript-language-server typescript

# Run tests
npm test -- --grep "lsp"

Dependencies

Internal

• None

External

Supported Language Servers