CLI Reference
quicx is the single binary that ships with the release. It is self-documenting — running it with no arguments prints the same usage you see below.
quicx v1.0.2 — lightweight task queue daemon
usage:
quicx start --config FILE
quicx stop
quicx status
quicx versionquicx start --config FILEBinds the port declared in [server], maps the PMAD pool, and begins accepting connections. Runs in the foreground — the calling shell owns the process. Pair with systemd, tmux, launchd or your container supervisor for lifecycle management.
--config is optional. When omitted, the daemon starts with the built-in default configuration (port 16381, 1 MiB pool, six size classes). Pass a path to override any or all values.
quicx stopSends SIGTERM to the pid recorded in /var/run/quicx.pid. The daemon drains in-flight tasks, munmaps the PMAD pool and exits cleanly.
quicx statusOpens a short-lived control connection over the /tmp/quicx.sock Unix socket and sends MSG_STATS, then renders the MSG_STATS_RESPONSE as a human-readable table. Shows uptime, worker pool state, queue depth, task counters, memory usage and a per-size-class PMAD slab breakdown. Safe to script — exits non-zero if the daemon is unreachable.
user@host ~ $ quicx status
quicx v1.0.2
─────────────────────────────────────────
uptime 0h 0m 6s
workers idle: 0 busy: 0 total: 0
queue waiting: 0
tasks submitted: 0
completed: 0
failed: 0
memory 32 / 913408 bytes (0.0%)
PMAD:
32B [░░░░░░░░░░░░░░░░░░░░] 1 / 2184
64B [░░░░░░░░░░░░░░░░░░░░] 0 / 3276
128B [░░░░░░░░░░░░░░░░░░░░] 0 / 1820
256B [░░░░░░░░░░░░░░░░░░░░] 0 / 770
512B [░░░░░░░░░░░░░░░░░░░░] 0 / 238
1024B [░░░░░░░░░░░░░░░░░░░░] 0 / 80
user@host ~ $quicx versionPrints the semver, build date and target triple. Machine-parsable if you pipe it — one line, space-separated.