---
title: "una lsp"
url: https://una-lang.org/en/docs/cli/lsp/
release: v0.4.0
---

# una lsp

Serve the language server on stdin and stdout, for editors.

```text
una lsp [OPTIONS]
```

## Examples

```sh
una lsp
```

Serve the language server; an editor starts it, not a person.

## Options

| Option | What it does | Default |
| --- | --- | --- |
| `--json` | Print machine output as JSON on stdout, and nothing else on stdout |  |
| `--color <WHEN>` | When to use colors in human output. Values: `never`: Never use colors; `auto`: Use colors when the output is a terminal; `always`: Always use colors. | `auto` |

## Specification

The normative rules, from spec/13 §5:

| Command | Meaning |
| --- | --- |
| `una lsp` | (v0.2, ADR 0063) The language server: LSP 3.17 over stdin and stdout, for editors. It checks, formats and solves; it never runs programs |




## Help text

As `una lsp --help` prints it at v0.4.0:

```text
Serve the language server on stdin and stdout, for editors (ADR 0063)

Usage: una lsp [OPTIONS]

Options:
      --json
          Print machine output as JSON on stdout, and nothing else on stdout

      --color <WHEN>
          When to use colors in human output

          Possible values:
          - never:  Never use colors
          - auto:   Use colors when the output is a terminal
          - always: Always use colors

          [default: auto]

  -h, --help
          Print help (see a summary with '-h')
```
