Skip to content
Skills Library
Programming · Analysis

typescript-lsp

/typescript-lsp

Use the TypeScript language server (`typescript-language-server`) for precise code intelligence in the `clickhouse-js` repository: go-to-definition, find references, hover (type signatures and JSDoc, including `@deprecated` info), workspace-wide symbol search, completions, and per-file type diagnostics. Prefer this over grep when you need to resolve a symbol's actual definition, find all usages of an exported API, or inspect inferred types across the `packages/*` workspaces. The server is preinstalled as a root devDependency — run the repository `setup` skill (`npm install`) first so `node_mod

Licence
Apache-2.0
Last repository change
26.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Use the TypeScript language server (`typescript-language-server`) for precise code intelligence in the `clickhouse-js` repository: go-to-definition, find references, hover (type signatures and JSDoc, including `@deprecated` info), workspace-wide symbol search, completions, and per-file type diagnostics. Prefer this over grep when you need to resolve a symbol's actual definition, find all usages of an exported API, or inspect inferred types across the `packages/*` workspaces. The server is preinstalled as a root devDependency — run the repository `setup` skill (`npm install`) first so `node_mod

Original author description

Use the TypeScript language server (`typescript-language-server`) for precise code intelligence in the `clickhouse-js` repository: go-to-definition, find references, hover (type signatures and JSDoc, including `@deprecated` info), workspace-wide symbol search, completions, and per-file type diagnostics. Prefer this over grep when you need to resolve a symbol's actual definition, find all usages of an exported API, or inspect inferred types across the `packages/*` workspaces. The server is preinstalled as a root devDependency — run the repository `setup` skill (`npm install`) first so `node_mod

How it works

  1. Starting the server
  2. Protocol essentials
  3. Verified capabilities (typescript-language-server 5.x, TS 6.x)
  4. Tips
Original SKILL.md headings · 54 lines, 341 words
SKILL.md preview
---
name: typescript-lsp
description: >
  Use the TypeScript language server (`typescript-language-server`) for precise
  code intelligence in the `clickhouse-js` repository: go-to-definition, find
  references, hover (type signatures and JSDoc, including `@deprecated` info),
  workspace-wide symbol search, completions, and per-file type diagnostics.
  Prefer this over grep when you need to resolve a symbol's actual definition,
  find all usages of an exported API, or inspect inferred types across the
  `packages/*` workspaces. The server is preinstalled as a root devDependency —
  run the repository `setup` skill (`npm install`) first so `node_modules` is
  populated. Do NOT use this skill for downstream projects that merely depend
  on `@clickhouse/client`; it is specific to working inside this repo.
---

# TypeScript Language Server in clickhouse-js

`typescript-language-server` is declared as a root devDependency, so after
`npm install` (see the `setup` skill) it is available via `npx` and uses the
workspace-local `typescript` (6.x) compiler, matching CI exactly.

The server (6.x) requires Node.js >= 22.22.2, newer than the repository's
Node 20 minimum; on Node 20 `npm install` only warns, but the server isn't supported there.

## Starting the server

From the repo root:

```bash
npx typescript-language-server --stdio
```

It speaks LSP (JSON-RPC, `Content-Length`-framed) over stdio. There is no
extra configuration: each `packages/*` workspace, `tests/clickhouse-test-runner`,
`examples/node`, and `examples/web` has its own `tsconfig.json`, and the
server picks the nearest one per opened file automatically.

## Protocol essentials

1. Send `initialize` with `rootUri`/`workspaceFolders` pointing at the repo
   root, then the `initialized` notification.
2. Send `textDocument/didOpen` with the full file text for every file you
   want to query (the server reads dependencies from disk on its own; only
   files you query positions in need to be opened).
3. Positions are **0-based** (line and character).

## Verified capabilities (typescript-language-server 5.x, TS 6.x)

| Request                   | Notes                                                                                                                                                                                                           |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `textDocument/hover`      | Returns the full inferred signature + JSDoc markdown                                                                                                                                                            |
| `textDocument/definition` | Resolves across workspace packages via source, not `dist/`                                                                                                                                                      |
| `textDocument/references` | Within the opened file's project                                                                                                                                                                                |
| `workspace/symbol`        | e.g. query `ClickHouseClient` finds class + re-exports                                                                                                                                                          |
| `textDocument/completion` | Context-aware member completions                                                                                                                                                                                |
| Diagnostics               | **Push only** (`textDocument/publishDiagnostics` notifications, sent ~1–3s after `didOpen`). The pull `textDocument/diagnostic` request is _not_ supported (`-32601`) — wait for the push notification instead. |

## Tips

- If your environment provides built-in LSP/code-intelligence tooling, point
  it at `npx typescript-language-server --stdio` with the repo root as the
  workspace folder.
- For one-off scripted queries, spawn the server from Node, frame messages
  with `Content-Length: <bytes>\r\n\r\n<json>`, and match responses by `id`.
- A full workspace typecheck is still `npm run build && npm run typecheck`
  (build first — some workspaces import compiled `dist/` outputs); the LSP is
  for targeted, interactive queries, not for CI-equivalent validation.

Versions

RepositoryScoreLicence
This page · clickhouse/clickhouse-js100Apache-2.0
msapps-mobile/claude-plugins100MIT

Database snapshot: 13.11.2026 · package version 2413996b4528 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100python-lsp
    Semantic Python code queries via a stdio LSP client driving pyright-langserver. Provides binding-resolved go-to-definition, find-references, hover types, type diagnostics, file symbol outlines, and project-wide symbol search — name resolution and type inference that tree-sitter…
  • 100lsp-setup
    Enable code intelligence (go-to-definition, find-references, hover, type info) for any programming language by installing and configuring an LSP server for Copilot CLI. Detects the OS, installs the right server, and generates the JSON configuration (user-level or repo-level).…
  • 90using-lsp-tools
    Use when mcp-language-server tools are available and you need semantic code intelligence. Triggers: 'find definition', 'find references', 'who calls this', 'rename symbol', 'type hierarchy', 'go to definition', 'where is this used', 'where is this defined', 'what type is this'.…
  • 100lsp-setup
    Enable code intelligence (go-to-definition, find-references, hover, type info) for any programming language by installing and configuring an LSP server for Antigravity CLI (agy). Detects the OS, installs the right server, and generates the JSON configuration (user-level or…
  • 100lsp-setup
    Enable code intelligence (go-to-definition, find-references, hover, type info) for any programming language by installing and configuring an LSP server for Copilot CLI. Detects the OS, installs the right server, and generates the JSON configuration (user-level or repo-level).…
  • 90lsp # prettier-ignore
    Use when implementing Language Server Protocol features - diagnostics, completions, hover, go-to-definition, and editor integration

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.