Skip to content

Product

CLI

The cellas command-line interface is the primary surface for verify, certify, test, and engine operations.

What it is

cellas is the composition-root CLI published as @cellas/conformance-cli. create-cellas scaffolds projects that already depend on it so new developers can reach PASS without cloning the monorepo.

Why it exists

A platform is only usable if the happy path is a short terminal sequence. The CLI makes First PASS (create → install → verify → certify) explicit and scriptable for CI.

When to use it

  • Every generated project’s day-to-day verification
  • CI pipelines that must fail on integrity or profile failures
  • Exploring Engine and conformance namespaces during development

How it works

pnpm exec cellas --help
pnpm exec cellas verify
pnpm exec cellas certify
pnpm exec cellas test --help
pnpm exec cellas engine --help

Relationship to other components

  • create-cellas installs the CLI into new projects
  • Commands delegate to Runtime, Engine, and Conformance packages
  • Exit codes and JSON output are designed for automation

Related

Next steps