cbq

Dispatch background jobs to database, Redis, or SQS queues in ColdBox and BoxLang applications.

1|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/ColdBox/skills --skill cbq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cbq
Source: https://github.com/ColdBox/skills/tree/main/modules/cbq
Command: npx skills add https://github.com/ColdBox/skills --skill cbq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Offload slow, blocking, or retry-prone work from request handlers to asynchronous background workers so web requests remain fast and resilient.

Core Features & Use Cases

  • Job class creation and dependency injection for encapsulating discrete units of work.
  • Queue configuration and routing to database, Redis, or SQS backends with delayed dispatch and worker pool management.
  • Retry handling, failed-job tracking, idempotent job patterns, chaining jobs, and monitoring for production workflows.
  • Use case: Send welcome emails and generate reports asynchronously, route high-priority jobs to a Redis-backed queue while keeping bulk jobs on a database queue.

Quick Start

Create and configure a SendWelcomeEmailJob that dispatches to the emails queue using the database connection with a 30-second delay.

Frequently Asked Questions about cbq

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I offload slow tasks like email sending to background jobs in ColdBox?

You can offload slow tasks like email sending to background jobs in ColdBox by dispatching them to asynchronous queues. This keeps web requests fast by shifting blocking operations to dedicated background workers.

Can I route background jobs to Redis or SQS queues in ColdBox?

Yes, you can route background jobs to Redis or SQS queues in ColdBox. The system supports queue configuration across database, Redis, and SQS backends, allowing you to direct high-priority jobs to Redis and bulk jobs to a database.

How do I handle retry logic and failed-job tracking for background queues?

You handle retry logic and failed-job tracking for background queues by configuring built-in retry handling and monitoring features. This ensures production workflows can automatically reattempt failed jobs and track idempotent job patterns.

Does ColdBox support delayed dispatch and job chaining for background workers?

Yes, ColdBox supports delayed dispatch and job chaining for background workers. You can dispatch jobs with specific delays, chain multiple jobs together sequentially, and manage worker pool concurrency for production workflows.

What is the best way to monitor worker concurrency and idempotency in job queues?

The best way to monitor worker concurrency and idempotency in job queues is to use built-in tracking and configuration features. This allows you to manage worker pools, enforce idempotent job patterns, and monitor failed-job tracking requirements.