Installation
Install the core @worker-manager/api plus one adapter for your framework.
Using a coding agent? Install the agent skill
Claude Code: /plugin marketplace add naldomadeira/worker-manager, then /plugin install worker-manager@worker-manager.
Any agent with a skills folder:
Then ask for the dashboard in plain words. See AI agent skill & setup.
Prerequisites
- Node.js 20+ or Bun 1.x. CI covers Node 20, 22 and 24.
- A running Redis instance
- Bull or BullMQ already set up in your app
Sharing an ioredis connection?
Worker Manager reads your existing Bull/BullMQ queues, so it inherits their Redis connection. If you construct BullMQ with a shared ioredis instance rather than a plain { host, port }, BullMQ requires that connection to be created with maxRetriesPerRequest: null. This is a BullMQ requirement, not a Worker Manager one, but it's the most common setup snag. See the BullMQ connection docs.
Install
Pick the adapter that matches your framework: