npm i -g @rotorsh/cli
rotor --version

rotor login
# Paste your rt_ws_* key. Saved to ~/.rotor/config.json (mode 0600).

rotor queues create <name> [options]
 
Options:
  --concurrency <n>           Max jobs processed in parallel (default: 1)
  --retry-attempts <n>        Attempts per job before moving to DLQ (default: 3)
  --callback-url <url>        HTTPS URL Rotor POSTs each job to
  --rotate-callback-secret    Generate a new HMAC signing secret (printed once)

rotor queues create enrichment \
  --concurrency 10 \
  --retry-attempts 5 \
  --callback-url https://your-app.example.com/rotor/enrichment

rotor queues list
# NAME         CONCURRENCY  JOBS (waiting/active/failed)
# enrichment   10           142 / 3 / 1
# outreach     5            0 / 0 / 0

rotor queues get <name>

rotor queues update <name> [options]
 
Options:
  --concurrency <n>
  --retry-attempts <n>
  --callback-url <url>
  --rotate-callback-secret    Rotate the signing secret; new value printed once

# Update callback URL and rotate the secret in one command
rotor queues update enrichment \
  --callback-url https://new-host.example.com/rotor/enrichment \
  --rotate-callback-secret

rotor queues delete <name>
# Prompts for confirmation. Pass --force to skip.

rotor jobs enqueue <queue> --payload <json> [options]
 
Options:
  --payload <json>            Job payload as a JSON string (required)
  --delay <seconds>           Delay before job becomes eligible
  --tags <tag,...>            Comma-separated list of tags
  --concurrency-key <key>     Mutual exclusion key (one job per key at a time)
  --idempotency-key <key>     Deduplicate — same key = same job, not a new one

rotor jobs enqueue outreach \
  --payload '{"contactId":"cid_123","campaignId":"camp_456"}' \
  --tags "campaign:q2-outbound,contact:cid_123" \
  --concurrency-key "contact:cid_123"

rotor jobs get <queue> <jobId>

rotor jobs list <queue> [options]
 
Options:
  --status <state>    Filter by state: waiting|active|completed|failed|delayed
  --tag <tag>         Filter by tag
  --limit <n>         Results per page (default: 50)

rotor jobs list enrichment --status failed
rotor jobs list outreach --tag campaign:q2-outbound

rotor jobs retry <queue> <jobId>
# Moves a failed job back to waiting. Resets attempt count.

rotor jobs cancel <queue> <jobId>
# Cancels a waiting or delayed job. Cannot cancel an active job.

rotor schedules create [options]
 
Options:
  --queue <name>           Queue to enqueue jobs into (required)
  --cron <expression>      Cron expression (required)
  --timezone <tz>          IANA timezone (required) — e.g. "America/New_York"
  --name <name>            Human-readable name for the schedule
  --payload <json>         Payload for each generated job

rotor schedules create \
  --queue enrichment \
  --cron "0 9 * * 1-5" \
  --timezone "America/New_York" \
  --name "weekday-morning-enrichment" \
  --payload '{"source":"clearbit"}'

rotor schedules list
# NAME                          CRON            NEXT FIRE
# weekday-morning-enrichment    0 9 * * 1-5     2026-05-21T09:00:00-04:00

rotor schedules pause <name>
# No new jobs fire until resumed. In-flight jobs are not affected.

rotor schedules resume <name>

rotor schedules delete <name> [--force]

rotor secrets create <NAME> --value <value>
 
# Or pipe the value to avoid shell history:
echo -n "sk_live_abc123" | rotor secrets create STRIPE_KEY --stdin

rotor secrets list
# NAME            HINT        CREATED
# STRIPE_KEY      sk_li…      2026-05-01
# RESEND_KEY      re_…        2026-05-10

rotor secrets delete <NAME> [--force]

rotor status
# API:    ok
# Redis:  ok
# Plan:   pro
# Quota:  12,450 / 100,000 jobs used this period
# Resets: 2026-06-01

rotor status --watch

rotor template add <template-name>

rotor template add outbound-with-approvals