@nuanced-dev/lsp

Nuanced LSP

Nuanced LSP is a TypeScript client library and CLI wrapper around agentic-labs/lsproxy. It exposes the upstream LSProxy API while adding container lifecycle commands and an ergonomic developer experience.

Quick start

Install the package:

npm install -g @nuanced-dev/lsp

Assuming all system dependencies are satisfied and the TypeScript client was successfully built, you should see confirmation the bin/nuanced-lsp binary was added.

Run the CLI:

nuanced-lsp --help
nuanced-lsp up /path/to/workspace
nuanced-lsp list-files
nuanced-lsp down

Example library usage:

import { NuancedLspClient } from '@nuanced-dev/lsp';

const client = new NuancedLspClient();
await client.up({ workspace: '/path/to/ws' });
console.log(await client.listFiles());
await client.down();

API overview

Below is a high-level overview of available API (arguments/options omitted here for brevity).

For all options and arguments, please see the `api reference.

nuanced-lsp <command> --help

Lifecycle

• up – Start the Nuanced LSP Docker container
• down – Stop the container
• logs – Print or stream container logs
• pull – Pull the Nuanced LSProxy Docker image
• run – Run a script inside the container
• status – Show Docker lifecycle status

System

• health – Check server health and language readiness flags

Workspace

• list-files – List files detected in the workspace
• read-source – Read file contents (optionally a range)

Symbols

• definitions-in-file – List symbol definitions in a file
• find-definition – Find the definition at a given position
• find-identifier – Find identifiers by name in a file
• find-referenced-symbols – Find symbols referenced by the identifier at a given position
• find-references – Find all references to the identifier at a given position

This should map 1:1 against the upstream LSProxy API reference.