chant serve lsp

llms.txt lists every page for an agent

Synopsis

chant serve lsp [path]

Description

chant serve lsp starts a Language Server Protocol server over stdio with Content-Length framing. Editors use it for completions, hover documentation, diagnostics, and code actions in chant projects.

Your editor or IDE plugin launches the server.

Capabilities

The server advertises capabilities based on which lexicon plugin providers are available:

Capability	Condition	Description
`textDocumentSync`	Always	Full document sync on open/change
`diagnosticProvider`	Always	Lint diagnostics for open `.ts` files
`completionProvider`	Plugin has `completionProvider()`	Resource and property name completions
`hoverProvider`	Plugin has `hoverProvider()`	Hover documentation for resource types
`codeActionProvider`	Plugin has `codeActionProvider()`	Quick-fix code actions

Completions

When a lexicon plugin provides completions, the server triggers on these characters:

.  (space)  "  '  `  (

Completions include resource type names, property names, intrinsic functions, and cross-file resource references.

Diagnostics

The server runs lint rules on every document open and change, publishing diagnostics in real time. Only .ts files are linted; other file types return empty diagnostics.

Diagnostics use the same rule set as chant lint, including all configured core rules (COR, EVL) and lexicon-specific rules.

Hover

When a lexicon plugin provides hover, the server returns documentation for resource types, property types, and attribute references at the cursor position.

Editor Setup

VS Code

Add this to your .vscode/settings.json or configure a VS Code extension that launches stdio-based LSP servers:

{
  "chant.lsp.path": "npx",
  "chant.lsp.args": ["chant", "serve", "lsp"]
}

Neovim (nvim-lspconfig)

local lspconfig = require('lspconfig')
local configs = require('lspconfig.configs')

configs.chant = {
  default_config = {
    cmd = { 'npx', 'chant', 'serve', 'lsp' },
    filetypes = { 'typescript' },
    root_dir = lspconfig.util.root_pattern('chant.config.ts', 'package.json'),
  },
}

lspconfig.chant.setup({})

Other Editors

Any editor that supports stdio-based LSP servers can use chant. The command is:

chant serve lsp

The server communicates over stdin/stdout using the standard LSP protocol with Content-Length framing.

Exit Codes

Code	Meaning
0	Clean shutdown
1	Unknown subcommand or startup failure