Kernel & Hub • Observability

Runtime & CLI

Commands, configuration, and exit codes for the Aetherra runtime.

CLI Configuration Exit codes

CLI

aetherra_os.py — start the OS/kernel.
python -m aetherra_hub.compat — start the Hub API.
tools/quality_gates.py — run tests/coverage quality gates.

Common commands

# Start Hub (default :3001)
python -m aetherra_hub.compat

# Start OS
python aetherra_os.py

# Smoke & standards
python tools/os_smoke.py
python tools/verify_ui_standards.py --dir src/lyrixa/ui --output ui_standards_report.md

Configuration

AETHERRA_HUB_URL — base URL the UI/widgets use.
AETHERRA_TOKEN — auth token for protected calls.
AETHERRA_PNA_ALLOW — enable PNA header on preflights.

Exit codes

0 — success / clean shutdown
1 — generic error
2 — configuration or environment error

Kernel

The kernel schedules tasks across queues (high/normal/background). Monitor via /metrics and the live widget.