Jobs

A job is a unit of work — a prompt, optional input data, and configuration — that gets queued, assigned to a worker, processed, and stored.

Job states

State	Description
pending	Queued, waiting for a worker
running	Assigned to a worker, in progress
completed	Finished successfully, result available
failed	Errored during processing
cancelled	Manually cancelled before completion

Dispatching a job

modelreins job dispatch \
  --prompt "Review this code for security issues" \
  --input ./handler.ts \
  --provider claude \
  --model sonnet \
  --priority high

Job priority

Jobs have three priority levels: low, normal (default), and high. Higher priority jobs are picked up first.

Retrieving results

modelreins job result <job-id>        # Get the output
modelreins job info <job-id>          # Full metadata: cost, tokens, duration
modelreins job list --status pending  # Filter by state

Automatic retries

If a worker crashes mid-job, the coordinator requeues the job after the configured timeout. See Troubleshooting for stuck job handling.