CLI Reference
Version: 0.24.1-alpha
The WCL command-line interface — parse, check, evaluate, edit, format, the language server, and the wdoc generator.
§ 1Global switches
| Switch | Value | Description | Remarks |
|---|---|---|---|
| -h, --help | — | Print help and exit. | — |
| -V, --version | — | Print the wcl version and exit. | — |
§ 2Commands
- wcl parse — Parse a file and print the resulting document tree (forces full evaluation).
- wcl check — Parse and validate against the schema. Exit 0 = valid, 1 = parse error, 2 = schema violation.
- wcl eval — Resolve a dotted path from the document root and print the value.
- wcl set — Update the field at a dotted path with a new WCL expression, following imports to the declaring file.
- wcl answer — Walk a document's pending @answerable interview questions (from import <answer.wcl>) and record the answers — arrow-key menus for choice questions, free text always available, each answer written back immediately through the validating edit pipeline.
- wcl fmt — Reformat to canonical form (comments and blank-line groupings preserved).
- wcl diff — Compare two documents (evaluated views) and print the changed entities and fields.
- wcl init — Scaffold a new project folder from a WCL template.
- wcl repl — Read-eval-print loop for ad-hoc WCL expressions.
- wcl lsp — Run the WCL language server over stdio (for editor integrations).
- wcl wdoc — The wdoc static-site / skill generator. Has its own subcommands.
- wcl wdoc build — Build a wdoc document into a static site.
- wcl wdoc skill — Project a wdoc :ai_skill target into a SKILL.md + references/ folder.
- wcl wdoc pdf — Render a wdoc document to a PDF.
- wcl wdoc serve — Build and serve a wdoc site locally with live reload.