Documentation

Run, check, or compile.

The professional CLI contract distinguishes successful execution, invalid source, usage errors, host failures, and unexpected internal failures.

Commands

kwechiri <file.kwe>
kwechiri run <file.kwe>
kwechiri check <file.kwe>
kwechiri compile <file.kwe>
kwechiri compile <file.kwe> --out build/app.js --force
kwechiri --version
kwechiri --help

The shorthand kwechiri file.kwe is equivalent to run. check validates the module graph without executing. compile writes directly runnable JavaScript without executing it.

Exit codes

CodeMeaning
0Success
1Kwechiri source, semantic, module, or runtime error
2Invalid CLI usage
3Filesystem or host failure
4Unexpected internal failure

Output safety

  • Program output goes to stdout.
  • Diagnostics go to stderr.
  • Compilation refuses to overwrite output without --force.
  • Output compilation does not replace an existing file when compilation fails.

Read the full CLI specification for the current contract.