Limits, Environment Variables, and Global Flags
Limits
| Name | Type | Minimum | Maximum | Unbounded |
|---|---|---|---|---|
attempt_number |
integer | 1 | 9223372036854775807 | no |
cwd_length |
path | 1 | 4096 | no |
duration_seconds |
duration | 0 | 31536000000.0 | no |
env_key_length |
string | 1 | 128 | no |
env_value_length |
string | 0 | 4096 | no |
event_limit |
integer | 0 | 10000 | no |
feedback_tail_bytes |
integer | 1 | 65536 | no |
id |
integer | 1 | 9223372036854775807 | no |
idempotency_key_length |
string | 1 | 256 | no |
limit |
integer | 0 | 1000 | no |
note_length |
string | 0 | 10000 | no |
poll_interval_seconds |
float | 0 | 3600.0 | no |
priority |
integer | -2147483648 | 2147483647 | no |
queue_name |
queue | 1 | 64 | no |
status_limit |
integer | 0 | 1000 | no |
tag_count |
integer | 0 | 16 | no |
tag_key_length |
string | 1 | 128 | no |
tag_value_length |
string | 0 | 1024 | no |
timeout_seconds |
integer | 1 | 9223372036854775807 | no |
timestamp_epoch_seconds |
timestamp | -31536000000.0 | 31536000000.0 | no |
wait_seconds |
float | 0 | 86400.0 | no |
worker_id_length |
string | 1 | 256 | no |
worker_slots |
integer | 1 | 9223372036854775807 | no |
Environment Variables
| Variable | Type | Default | Description |
|---|---|---|---|
SPOOLCTL_DB |
path | ./.spoolctl/queue.db | queue database path (precedence: –db flag, SPOOLCTL_DB, .spoolctl/config.json db_path, ./.spoolctl/queue.db) (consumed by: add, cancel, config-show, doctor, events, feedback, list, output, prune, retry, show, status, wait, work) |
SPOOLCTL_TEST_HEARTBEAT_INTERVAL |
float | 5.0 | test-only: seconds between worker heartbeats (default 5) (consumed by: work) |
SPOOLCTL_TEST_REAP_THRESHOLD |
float | 30.0 | test-only: seconds of heartbeat staleness before a running job becomes a reap candidate (default 30) (consumed by: work) |
Global Flags
| Flag | Type | Description |
|---|---|---|
--help |
boolean | |
--version |
boolean |
Database scope: –db is verb-local on database-reading verbs, not global