Editor Integrations

What Ships

Chio includes two extensions and a shared snippet pack. The VS Code extension is a TypeScript package; the Zed extension is a Rust crate that compiles to wasm32 for the editor and to a plain rlib on host targets so the workspace build exercises its manifest contract. The snippet source is shared and each editor receives its native format.

Supported Documents

Both editors target the same three Chio document types, keyed by filename or suffix. A chio.yaml is a project's config file: it points at a HushSpec policy file or inline block, lists capabilities, and activates guards. Manifests describe tools and capabilities; guard DSL files describe guard pipelines.

VS Code contributes the three IDs above; Zed contributes a single Chio language scoped to the same suffixes (chio.yaml, chio-manifest.yaml, chio-guard.yaml). Both reuse a YAML tree-sitter grammar for highlighting and scope it to the Chio constructs: capability, policy, and guard keys, and urn:chio:error:* references.

Install

Both extensions depend on the chio-lsp binary. Build it first and put it on your PATH, or pin an absolute path in the editor settings below.

# Build the language server binary.
$ cargo build --release -p chio-lsp

Load the VS Code extension from its package directory:

$ cd integrations/editors/vscode-chio
$ npm install
$ npm run compile
# Launch via "Run Extension" (F5) inside VS Code, or package it:
$ npx @vscode/vsce package

Load the Zed extension as a dev extension: open the command palette and run Zed: Install Dev Extension, then point it at integrations/editors/zed-chio.

What the language server provides

chio-lsp classifies each open document by language ID or file suffix and serves four request classes from a shared document cache. It stops at the document boundary: it does not run the kernel, evaluate policy, or read arbitrary project files.

The chio.yaml top-level keys the completion catalog offers are version, policy, capabilities, guards, and manifest. Of these, version and policy are required: a chio.yaml missing either surfaces a diagnostic carrying urn:chio:error:cli:doctor-chio-yaml-invalid, the same code the chio doctor probe emits, so the editor and the CLI agree on what counts as valid.

Configuration

By default both editors resolve chio-lsp on PATH and spawn it with no extra arguments. Override the binary path or forward flags when the server lives somewhere non-standard.

VS Code

The extension contributes three settings under the chio namespace.

{
  "chio.lsp.path": "/opt/chio/bin/chio-lsp",
  "chio.lsp.args": [],
  "chio.trace.server": "off"
}

Zed

Zed reads the standard lsp.<server>.binary block. The server id is chio-lsp. An empty or whitespace-only path falls back to the bare chio-lsp invocation, so the default PATH lookup still works.

{
  "lsp": {
    "chio-lsp": {
      "binary": {
        "path": "/opt/chio/bin/chio-lsp",
        "arguments": ["--verbose"]
      }
    }
  }
}

Both editors let you override the binary path and launch arguments.

Snippets

The extensions include four snippets for common authoring patterns. Type a prefix and expand it; each snippet uses LSP-standard ${1:label} placeholders so both editors accept the same source.

Expanding manifest-skeleton drops in a complete starting manifest with the default values already filled:

version: 1
name: manifest_name
policy:
  default: deny
capabilities:
  - id: capability_id
    scope:
      - scope.action
guards:
  - ref: guard.identifier

Snippet sources are tool-neutral YAML at integrations/editors/snippets/*.snippet.yaml, validated against a JSON schema. A build task renders them into each editor's native format; the generated files carry a generated by cargo xtask snippets regen header and are checked for drift in CI.

$ cargo xtask snippets regen          # regenerate native files
$ cargo xtask snippets regen --check  # CI drift check (no writes)

Diagnostics and registry codes

Every diagnostic carries a registry code in its LSP code field, formatted as urn:chio:error:<domain>:<code> — for example urn:chio:error:capability:scope-mismatch. The editors render the URN unchanged; downstream tooling matches on the code field programmatically. The source is chio-lsp, and locations are anchored to the offending token so the editor can place a squiggle.

Other editors

Any LSP-capable editor (Neovim, Helix, JetBrains, Emacs lsp-mode) can use chio-lsp without a first-party extension. Configure:

• Binary: chio-lsp, resolved on PATH by default, pinnable to an absolute path.
• Transport: LSP over stdio, no environment variables required.
• Selectors: map the client to chio.yaml, *.chio-manifest.yaml, and *.chio-guard.yaml.
• Diagnostics: read the urn:chio:error:* code from each diagnostic's code field and render it as-is.

Next steps

• Write a Policy · author HushSpec rules that the guard pipeline enforces
• HushSpec Policy Format · the policy schema used by editor completions
• chio.yaml Configuration · the project config file the extensions validate
• Capabilities · scopes and bounds referenced by the capability snippets