Open Source Capability Linter
Polychro validates Ikanos capability YAML plus semi-structured specifications such as YAML, JSON, XML, Markdown, and HTML through composable layers — well-formedness, schema-model, ruleset, and format-aware validation in a single, embeddable pipeline with sub-second latency.
Designed for AI agent loops where non-deterministic generation needs deterministic guardrails. Apache 2.0 licensed.
Features
Layered Validation
Well-formedness, schema-model, ruleset, and format-aware checks in one pipeline — all producing the same unified Diagnostic format.
Schema-Model Validation
Formal document models including JSON Schema Draft 2020-12 and JSON Structure.
Spectral-Format Rulesets
Execute governance rulesets with given/then semantics over YAML, JSON, XML, Markdown, and HTML.
CLI & Native Executable
Single standalone binary for Linux, macOS, and Windows — no JVM required.
MCP Server & GitHub Action
Expose linting as MCP tools for AI agent loops, or run it in CI with structured SARIF output.
Embeddable & Extensible
In-process Java API, SDK clients for Go, Node.js / TypeScript, and Python, polyglot custom functions on sandboxed GraalVM, and a ServiceLoader SPI for custom validators.
Quick start
CLI
polychro lint my-spec.yml
polychro lint --ruleset polychro:governance my-spec.yml
polychro lint --config .polychro.yml welcome-email.html
polychro lint --format agent my-spec.yml
MCP Server
polychro serve --ruleset polychro:ai-safety
Learn more in the Shipyard
The full Polychro documentation — getting started, guides, reference, and roadmap.
Lint your specs with Polychro
Apache 2.0, native binaries, MCP server mode. Start with the README on GitHub or follow the Shipyard tutorials.
