@rotorsh/cli

Command-line interface for Rotor — manage queues, schedules, jobs, DLQ replay, API keys, and workspaces from your terminal. Built for Claude Code-using GTM engineers.

60-second quickstart

# 1. Install globally
npm i -g @rotorsh/cli

# 2. Authenticate (paste your rt_ws_* workspace API key when prompted)
rotor login

# 3. Create your first queue
rotor queues create welcome-emails --concurrency 5 --retry-attempts 3

# 4. Inspect workspace status
rotor status

That's it — you now have a queue ready to receive jobs. See the full quickstart for the 30-minute callback-handler walkthrough.

Full install guide

→ docs.rotor.sh/quickstart

Common commands

rotor queues list              # see all queues with depth + concurrency
rotor schedules create --cron "0 9 * * *" --timezone UTC --queue welcome-emails
rotor jobs add welcome-emails  # enqueue a single job (payload via --data or stdin)
rotor jobs add-batch welcome-emails --file batch.json  # enqueue from JSON/CSV
rotor dlq list                 # inspect dead-letter queue
rotor dlq replay <jobId>       # idempotent replay
rotor status --watch           # live workspace dashboard (Ctrl+C to exit)

Every command supports --json for piping to jq. Run rotor <group> --help for the full flag set.

What this is

A workspace-scoped CLI that talks to api.rotor.sh over REST. The same backend powers the Rotor SDK, MCP server, and dashboard.

What this is not

• An admin tool. Workspace-creation and team-administration are operator-only and ship in a separate channel.
• A worker runtime. To process jobs in your own code, install @rotorsh/sdk and use the Worker class — or configure HTTP callbacks per queue.

License

Closed-source — rotor.sh commercial license. Bug reports welcome at github.com/shyftai/rotor/issues.