ts-lsp

ts-lsp

TypeScript LSP plugin for Claude Code with full-workspace findReferences support.

Drop-in replacement for the official typescript-lsp plugin. Auto-discovers all tsconfig.json projects at startup and forces TSServer to load them, so findReferences and incomingCalls search the entire workspace instead of just the nearest project.

Why?

TSServer only loads projects for files that have been explicitly opened. In monorepos with many packages, this means findReferences only searches a fraction of the codebase. This plugin fixes that by opening one entry file per tsconfig.json project during initialization.

• Single-tsconfig projects: Zero overhead (discovers 1 file, opens it)
• Monorepos: Dramatically better coverage (tested with ~100 packages, goes from ~43 to 200+ results)

Prerequisites

npm install -g typescript-language-server typescript

Both must be available on your PATH.

Installation

From marketplace

If available in your Claude Code plugin marketplace, enable ts-lsp and disable the official typescript-lsp.

Manual (local directory)

claude --plugin-dir ~/path/to/ts-lsp

Or add to your Claude Code settings:

{
  "plugins": {
    "ts-lsp": { "source": "local", "path": "~/path/to/ts-lsp" }
  }
}

Make sure to disable the official TypeScript LSP plugin to avoid conflicts.

How It Works

1. Claude Code starts the proxy via .lsp.json
2. The proxy spawns typescript-language-server --stdio as a child process
3. It intercepts the LSP initialize request to extract workspace root(s)
4. On initialized, it walks the workspace to find all tsconfig.json files
5. For each project, it picks an entry file and sends a textDocument/didOpen notification
6. After warmup completes, the proxy becomes a transparent byte-level passthrough

Entry file selection

For each tsconfig.json directory, the proxy tries these candidates in order:

1. src/index.ts
2. src/index.dts.ts
3. src/main.ts
4. src/index.tsx
5. src/main.tsx
6. index.ts
7. main.ts
8. index.tsx
9. main.tsx
10. First .ts/.tsx file in src/
11. First .ts/.tsx file in the directory

Skipped directories

The walker skips: node_modules, dist, .git, build, out, .next, .nuxt, .cache, coverage, .turbo, .nx, and any directory starting with .

Configuration

All configuration is via environment variables:

Variable	Default	Purpose
TS_LSP_DEBUG	off	Log discovery and didOpen activity to stderr
TS_LSP_MAX_FILES	250	Maximum files to open during warmup
TS_LSP_BATCH_SIZE	5	Files per didOpen batch
TS_LSP_BATCH_DELAY	50	Milliseconds between batches

To enable debug logging, set the environment variable before launching Claude Code:

TS_LSP_DEBUG=1 claude

Comparison to Official Plugin

Feature	Official typescript-lsp	ts-lsp
Spawns typescript-language-server	Yes	Yes
Language mappings	.ts, .tsx, .js, .jsx	+ .mts, .cts, .mjs, .cjs
Monorepo workspace loading	Only opened files	All tsconfig.json projects
findReferences coverage	Partial (nearest project)	Full workspace
Dependencies	None	None
Overhead for single-project repos	N/A	Negligible (opens 1 file)