SecaniDocumentation
OSCAL

CLI

Preview the planned command-line interface for OSCAL validation and conversion.

Installation preview

Coming soon: oscal-cli is not published yet. Every command on this page is illustrative.

The CLI is separate from the implemented TypeScript toolkit and is not published yet. The commands on this page describe the intended CLI contract, not functionality available from @secani/oscal today.

npm install --global oscal-cli

Validate

oscal-cli validate ./system-security-plan.json

Validation is planned to check a document against the relevant OSCAL model and return actionable diagnostics.

Convert

oscal-cli convert ./catalog.xml --to json

Conversion is planned for OSCAL's JSON, XML, and YAML serializations.

Inspect

The planned inspection commands will summarize a document's model, identifiers, and high-level structure without changing the source file.

oscal-cli inspect ./profile.json

Output formats

Human-readable terminal output and machine-readable output for automated workflows are planned.

Exit codes

The published CLI will document stable exit codes for successful commands, validation findings, and command errors.