CLI Reference

CLI Reference

The policyaware CLI helps developers test policies, explain decisions, classify risk, validate tool governance, run evals, and inspect audit data.

Policy Commands

Validate a YAML policy:

policyaware policy validate examples/policies/basic.yaml

Run a basic policy test:

policyaware policy test examples/policies/basic.yaml

Explain a policy decision:

policyaware policy explain examples/policies/basic.yaml \
  --prompt "Email jane@example.com about the claim"

Risk Classification

policyaware risk classify "Summarize this patient diagnosis" --domain healthcare

Tool Governance

policyaware tools check examples/policies/tool-governance.yaml \
  --agent code_assistant \
  --connector github \
  --action create_pr \
  --role developer

Evaluation

policyaware eval run examples/evals/executable_governance_cases.yaml \
  --policy-file examples/policies/basic.yaml

Audit

Create an audit bundle:

policyaware audit bundle .policyaware/traces.jsonl --output audit_bundle

Replay a trace:

policyaware audit replay .policyaware/traces.jsonl --trace-id trc_example

Create an HTML trace viewer:

policyaware audit view .policyaware/traces.jsonl --output trace-viewer.html

Observability

Prometheus text output:

policyaware observability prometheus .policyaware/traces.jsonl

OpenTelemetry-shaped JSON:

policyaware observability otel-json .policyaware/traces.jsonl

Local Simulation

policyaware dev simulate examples/policies/basic.yaml