typescript-lsp

tenequm's avatarfrom tenequm

TypeScript Language Server Protocol capabilities for navigating TypeScript/JavaScript code. Resolves imported symbols to their definitions (including node_modules), finds all references to functions/classes/variables, gets type information and signatures, previews rename impacts, and checks TypeScript diagnostics. Use when you need to find where ToolLoopAgent or other imports are defined, locate all usages of a function, see TypeScript types, or get compiler errors.

⭐2stars🔀0forks📁View on GitHub🕐Updated Oct 29, 2025
[Developer Tools]

When & Why to Use This Skill

The TypeScript LSP skill integrates powerful Language Server Protocol capabilities into Claude, enabling advanced navigation and static analysis for TypeScript and JavaScript projects. It empowers the agent to resolve complex symbols, track references across the entire workspace, inspect deep type information, and perform real-time diagnostic checks, bridging the gap between AI assistance and professional IDE functionality.

Use Cases

  • Deep Code Navigation: Resolving imported symbols and jumping to definitions across local files and external node_modules to understand complex dependencies.
  • Impact Analysis & Refactoring: Locating every usage of a function, class, or variable to safely plan changes or evaluate the scope of a refactor.
  • Type Safety & Debugging: Accessing precise TypeScript type signatures and JSDoc documentation to resolve type mismatches and logic errors.
  • Pre-compilation Diagnostics: Retrieving real-time compiler errors and warnings to identify bugs before the code is even executed.
  • Refactoring Previews: Using the rename dry-run feature to visualize how a symbol change propagates through the codebase, ensuring consistency.
nametypescript-lsp
descriptionTypeScript Language Server Protocol capabilities for navigating TypeScript/JavaScript code. Resolves imported symbols to their definitions (including node_modules), finds all references to functions/classes/variables, gets type information and signatures, previews rename impacts, and checks TypeScript diagnostics. Use when you need to find where ToolLoopAgent or other imports are defined, locate all usages of a function, see TypeScript types, or get compiler errors.
allowed-toolsBash, Read

TypeScript LSP Skill

This skill provides full TypeScript Language Server Protocol capabilities for navigating and analyzing TypeScript/JavaScript code.

When to Use This Skill

Use this skill when you need to:

  • Resolve imported symbols - Find where ToolLoopAgent, React.Component, or other imported types are defined (including in node_modules)
  • Find all references - Locate every place a function, class, or variable is used across the codebase
  • Get type information - See TypeScript type signatures and documentation
  • Preview renames - Check what would change when renaming a symbol
  • Check diagnostics - Get TypeScript errors and warnings for a file

Commands Available

typeDefinition - Jump to Type Definition

Resolves imported symbols to their actual definitions (works with node_modules).

Example:

node .claude/skills/typescript-lsp/typescript-lsp.js typeDefinition src/lib/ai/agents/transaction-debugger.ts 4 30

When to use: Finding where ToolLoopAgent is defined, navigating to React types, or any imported symbol.

definition - Jump to Definition

Standard go-to-definition (works for local symbols).

Example:

node .claude/skills/typescript-lsp/typescript-lsp.js definition src/lib/transaction.ts 10 15

references - Find All References

Locates every usage of a symbol across the entire workspace.

Example:

node .claude/skills/typescript-lsp/typescript-lsp.js references src/lib/ai/agents/transaction-debugger.ts 9 37

When to use: Finding all places that call a function or use a variable.

hover - Get Type Info

Shows TypeScript type information and JSDoc documentation.

Example:

node .claude/skills/typescript-lsp/typescript-lsp.js hover src/lib/transaction.ts 20 10

When to use: Understanding what type a variable has or seeing function signatures.

rename - Preview Rename (Dry-Run)

Shows what would change when renaming a symbol.

Example:

node .claude/skills/typescript-lsp/typescript-lsp.js rename src/lib/transaction.ts 15 10 newFunctionName

When to use: Checking the impact of a rename before doing it.

diagnostics - Get Errors/Warnings

Retrieves TypeScript compiler diagnostics for a file.

Example:

node .claude/skills/typescript-lsp/typescript-lsp.js diagnostics src/app/page.tsx

When to use: Checking for TypeScript errors before compiling.

Position Parameters

All commands (except diagnostics) require line and character positions:

  • Line: 0-indexed line number (first line is 0)
  • Character: 0-indexed character offset in the line

Tip: When you see import { ToolLoopAgent } from "ai" on line 5, use line 4 (0-indexed) and count characters to find where "ToolLoopAgent" starts.

Output Format

The skill outputs Claude Code-friendly format:

  • File paths with line:column (e.g., src/file.ts:10:5)
  • Code snippets in markdown fences
  • Clear headings and formatting

Limitations

  • Requires typescript-language-server to be installed
  • Works best when run from the project root
  • Takes 1-3 seconds per query (single-query mode)
  • Requires the file to exist on disk

Examples for Common Tasks

Find where ToolLoopAgent is defined:

node .claude/skills/typescript-lsp/typescript-lsp.js typeDefinition src/lib/ai/agents/transaction-debugger.ts 4 30

Find all uses of transactionDebugger:

node .claude/skills/typescript-lsp/typescript-lsp.js references src/lib/ai/agents/transaction-debugger.ts 9 37

Check if a file has TypeScript errors:

node .claude/skills/typescript-lsp/typescript-lsp.js diagnostics src/app/page.tsx