awarer

Documentation / Reference

awa exit codes

awa v0.3.1 · slug exit-code-reference

On this page

The exact process-exit contract. Each code has a stable number and a stable machine name; the meanings and the diagnosis guidance live in the operational topic linked below.

awa-owned exit statuses

  • 0 — success
  • 1 — generic-error
  • 2 — usage-error
  • 3 — not-found
  • 4 — config-error
  • 5 — state-action-required
  • 6 — lock-timeout
  • 130 — interrupted

Wrapped child exits

awa run returns the wrapped command's own exit code rather than an awa code.

A child's code can overlap awa's own range, so the exit status alone does not identify the origin. The run envelope disambiguates it in data.run.exit_origin.

  • Interruption of a normal command: 130.
  • Interruption of a wrapped child: child signal-derived (e.g. 137 for SIGKILL).

See also