Install the CLI

The awa command runs migrations, inspects and administers queues, and can host the optional web dashboard.

uv tool (recommended)Project dependencyRelease binary

uv tool install awa-cli==0.6.6
awa --help

uv add 'awa-pg[ui]==0.6.6'
uv run python -m awa --help

python -m awa delegates to the bundled awa binary inside the project environment.

Download the archive for your platform from the GitHub Releases page, then put awa on your PATH.

Point commands at PostgreSQL with --database-url or DATABASE_URL:

export DATABASE_URL=postgres://awa_runtime:secret@db.example.com/app
awa health
awa queue stats
awa job list --queue email

Continue to the CLI command map or launch the dashboard with awa serve.