Chapter 11

CLI Reference

Run, check, format, use the REPL, and inspect dry-run plans.

Commands

hhy run script.hhy
hhy check script.hhy
hhy fmt script.hhy
hhy run --dry-run script.hhy
hhy repl
hhy --version

run: execute a script and pass args
check: static Parser and Checker validation
fmt: normalize source formatting
ast / tokens: inspect compiler structures
dry-run: intercept file writes, process launches, and network sends, then print a redacted plan

Stable exit codes

V1.0 defines exit codes 0–5 for success, runtime failure, syntax/check failure, usage error, resource limit, and internal error. Automation should branch on exit codes rather than error text.