Optics Framework

Diagnostics, completion, hover, goto-definition, references, rename, workspace symbol search and semantic highlighting for optics-framework CSV and YAML test suites, powered by optics-framework-lsp.

Everything is project-wide: a name defined in one file resolves references in every other file in the workspace, so completion, goto-definition and rename all work across files, not just within one.

Requirements

VS Code 1.101 or newer, for the MCP API below.
The Python extension, with an interpreter selected (Python 3.12+).

No other install step: the language server's own pure-Python dependencies ship inside this extension.

The server attaches to every *.csv, *.yaml and *.yml file in the workspace. Files that are not optics suites produce no diagnostics, because the parser classifies each file by its header row.

AI agents

The extension also offers the server over MCP, so an agent can ask it about the whole project rather than only the open files. It appears under MCP Servers, and Copilot needs no setup. The bridge is agent-lsp, downloaded on first use.

Claude Code reads its own config, so for that one run Optics: Configure LSP MCP Server for Claude Code and pick global or project. It also installs a skill telling the agent where the optics documentation is, for whichever of Claude Code, Cursor and the Gemini CLI you have.

Settings

setting	default
`optics.server.pythonCommand`	unset	override the interpreter the Python extension selects
`optics.trace.server`	`"off"`	log LSP traffic to the "Optics" output channel
`optics.mcp.enabled`	`true`	offer the server to AI agents over MCP
`optics.mcp.binaryPath`	unset	use this `agent-lsp` binary rather than downloading one

Commands

Optics: Restart Language Server
Optics: Configure LSP MCP Server for Claude Code

License

Apache-2.0

Optics Framework

Mozark

Optics Framework

Requirements

AI agents

Settings

Commands

License