Nuanced LSP runs as a Docker container. The following outlines the API for starting, stopping, modifying the container environment, viewing logs, and managing the Nuanced LSP Docker container and image.
CommandDescription
UpStart the container.
DownStop the container.
LogsView the container logs.
PullPull the nuanced-lsproxy image.
RunRun a script within the container environment.
StatusCheck the status of the container.
The Pull command is useful for pre-pulling the nuanced-lsproxy image for faster startup times, or to update to the latest version.

​
Up

Starts the Nuanced LSP container. 
> nuanced-lsp-ts up /path/to/workspace

​
Arguments

ArgumentDescriptionRequired
workspacePath to the host workspace to mount within the Nuanced LSP container✅

​
CLI options

OptionDescriptionDefault
--host-port <n>Host port to bind to container process4444
--bind-host <host>Host/IP to bind (e.g. 127.0.0.1, 0.0.0.0, 192.168.1.10)"127.0.0.1"
--image <ref>Docker image to use for standing up the container process"ghcr.io/nuanced-dev/nuanced-lsproxy:<version>"
--container-name <name>Container name"nuanced-lsp"
--timeout <s>Health check poll loop timeout seconds (<=0 to skip)120
--sudoDocker commands are executed with sudoDocker commands are executed without sudo
--streamProcess stdout, stderr, and container logs are streamed to the CLI’s stdoutProcess stdout, stderr, and container logs are not streamed
--roMount workspace as read-onlyMount workspace is read-write

​
Result

Success result confirms the container is running and bound to the specified host and port:
Nuanced LSP container 'nuanced-lsp' bound at 127.0.0.1:4444
Any error result is thrown as an exception.

​
Down

Stops the Nuanced LSP container. 
> nuanced-lsp-ts down

​
CLI options

OptionDescriptionDefault
--container-name <name>Container name"nuanced-lsp"
--timeout <s>Timeout seconds (<=0 to skip)120
--sudoDocker commands are executed with sudoDocker commands are executed without sudo

​
Result

Success result confirms the container was stopped:
Nuanced LSP Stopped container 'nuanced-lsp'.
Any error result is thrown as an exception.

​
Logs

Print logs from the Nuanced LSP container. 
> nuanced-lsp-ts logs

​
CLI options

OptionDescriptionDefault
--container-name <name>Container name"nuanced-lsp"
--timeout <s>Timeout seconds (<=0 to skip)120
--sudoDocker commands are executed with sudoDocker commands are executed without sudo
--streamProcess stdout, stderr, and container logs are streamed to the CLI’s stdoutProcess stdout, stderr, and container logs are not streamed
--since <when>Only show logs since (e.g. 10s, 5m, or RFC3339 timestamp)—
--tail <n|all>Show last N lines, or all for full history—

​
Result

On success, logs are printed to stdout.Example:
[2025-09-02T17:02:11Z] Starting Nuanced LSP...
[2025-09-02T17:02:12Z] Listening on 127.0.0.1:4444
If the container is not running, an error is shown.

​
Pull

Pull the Nuanced LSP image. 
> nuanced-lsp-ts pull

​
CLI options

OptionDescriptionDefault
--image <ref>Nuanced LSP Docker image to pull"ghcr.io/nuanced-dev/nuanced-lsproxy:<version>"
--sudoDocker commands are executed with sudoDocker commands are executed without sudo
--streamProcess stdout, stderr, and container logs are streamed to the CLI’s stdoutProcess stdout, stderr, and container logs are not streamed

​
Result

On success, the image is pulled and confirmation is shown.Example:
Pulled image ghcr.io/nuanced-dev/nuanced-lsproxy:0.3.8
Any error result is thrown as an exception.

​
Run

Run a script inside the Nuanced LSP container.
The script is copied to the container and is executed within the container as the root user.
> nuanced-lsp-ts run ./scripts/setup.sh

​
Arguments

ArgumentDescriptionRequired
scriptPath to a script to copy to the container and execute✅

​
CLI options

OptionDescriptionDefault
--container-name <name>Container name"nuanced-lsp"
--timeout <s>Timeout seconds (<=0 to skip)120
--sudoDocker commands are executed with sudoDocker commands are executed without sudo
--streamProcess stdout, stderr, and container logs are streamed to the CLI’s stdoutProcess stdout, stderr, and container logs are not streamed

​
Result

On success:
Script executed successfully in nuanced-lsp.
On failure, the error is printed, and the process exits with exit code 1.

​
Status

Show the container lifecycle status of the Nuanced LSP container. This command does not perform a /health probe. It only checks Docker’s view of the container. 
> nuanced-lsp-ts status

​
CLI options

OptionDescriptionDefault
--jsonOutput raw JSON—
--container-name <name>Container name"nuanced-lsp"
--timeout <s>Timeout seconds (<=0 to skip)120
--sudoDocker commands are executed with sudoDocker commands are executed without sudo

​
Result

Default output:
Container: nuanced-lsp
Running:   yes
Docker:    Up 29 minutes
With --json:
{
  "container_name": "nuanced-lsp",
  "running": true,
  "container_status": "Up 28 minutes"
}