CLI usage

A standalone flexiq command (no Python) operates the queue from the terminal. Connect with --db <path>, or --backend/--dsn for Postgres/Redis.

flexiq --db flexiq.db enqueue add '[2,3]'
flexiq --db flexiq.db stats
flexiq --db flexiq.db jobs --status failed
flexiq --db flexiq.db dlq list
flexiq --db flexiq.db dlq retry <deadId>
flexiq --db flexiq.db pause default
flexiq --db flexiq.db resume default
flexiq --db flexiq.db paused
flexiq --db flexiq.db cancel <jobId>

Add --json to any read command for machine-readable output.

Running a worker

run loads a module that exports a configured Queue and runs its worker:

flexiq run ./app.js --queues default,emails

The module registers its tasks on the exported queue; run starts a worker over them. Use it as your container entrypoint for worker processes.

Serving the dashboard

flexiq --db flexiq.db dashboard --port 8787

Serves openly by default. --auth enables session authentication (login/setup, CSRF, roles); --token <token> uses the legacy shared-token gate instead — see Dashboard.

KEDA scaler

flexiq --backend postgres --dsn "$DATABASE_URL" scaler --port 9091

Serves the queue-depth metric for KEDA.

Autoscaling worker processes

flexiq --db flexiq.db autoscale ./app.js --min-workers 2 --max-workers 20

Spawns and drains run-style workers to track queue depth, for hosts without Kubernetes — see Autoscaling.