vyges-power — CLI reference

Generated from vyges-power --help. Do not edit by hand — run scripts/gen-cli-reference.sh.

vyges-power — gate-level power analysis (leakage + dynamic) with a CI gate

usage:
  vyges-power run   JOB [-o OUT] [--json] [--fail-on-budget]
  vyges-power check JOB
  vyges-power demo       [-o OUT] [--json]

A JOB is a small declarative `.pwr` file (netlist + lib(s) + clock + activity).
With `vcd:` or `saif:` it uses measured per-net toggle rates; otherwise a
vectorless `activity:` factor × clock. With `emit_activity:` it writes the
per-instance map that vyges-em-ir consumes (closing char -> power -> em-ir).

flags:
  -o FILE             write the report to FILE (default: stdout)
  --json              machine-readable JSON instead of the text report
  --fail-on-budget    exit 3 if total power exceeds the job's power_budget_mw
  -q, --quiet         suppress non-essential output
  -v, --verbose       extra detail on stderr
  --describe          print a machine-readable JSON description of the command
  -h, --help          show this help
  -V, --version       show version
  --bug-report        file a bug (central: vyges/community)
  --feature-request   request a feature (central)
  --sponsor           sponsor Vyges (github.com/sponsors/vyges-ip)
  --star              star this tool on GitHub ⭐

Contract

Generated from vyges-power --describe.

power

gate-level power analysis (leakage + dynamic) with a CI gate

Maturity: workflow-validated

run {job}

Consumes: netlist, liberty, vcd

Artifacts: power_report (out)

Assertion: power-analysis — none; this operation establishes no engineering claim

Provenance limitations

• The job names the netlist, Liberty and any VCD/SAIF activity; input_hash covers the job path and arguments, not their contents.