CLI

CLI

pyscriptc <command> [options]

Global flag: -v / --verbose enables DEBUG audit records on any subcommand (see debugging and logs).

compile

Lower a source file or package directory.

pyscriptc compile FILE [options]
Flag Effect
--emit ir|llvm|bin Stop after JSON IR, textual LLVM, or a linked binary (default llvm)
-o PATH Output path; defaults to the source stem
--call FUNC Emit a main that calls FUNC and prints its return
--args '[...]' Arguments for --call, a Python list literal
--run Emit a binary and run it immediately
--driver clang|zig C toolchain driver; zig enables --target (default clang)
--target TRIPLE Cross-compile triple for zig cc, e.g. aarch64-linux-gnu.2.39
--skip-check Skip the mypy preflight
--checker mypy Preflight checker (default mypy)
--debug[=WHAT] Print a stage table; WHAT is a comma list of stages,fences,cc,paths,all
--debug-dir DIR Write ir.json, out.ll, cc.sh, summary.json to DIR

coverage

pyscriptc coverage SOURCE [--json]

Report every fence in a file or a package tree — per-module counts and codes, useful for scoping a port.

explain

pyscriptc explain PSxxxx

Print the description of a diagnostic code.

logs

pyscriptc logs

Print the audit-log path and its last ~50 lines. This is the output to paste into an issue.

telemetry

pyscriptc telemetry status|enable|disable

Manage anonymous usage metrics. See telemetry and privacy.