bunqueue

Set up bunqueue job queues and workers in Bun with SQLite persistence.

528|17|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/egeominotti/bunqueue --skill bunqueue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bunqueue
Source: https://github.com/egeominotti/bunqueue/tree/main/skills/bunqueue
Command: npx skills add https://github.com/egeominotti/bunqueue --skill bunqueue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you set up and run reliable background job processing in Bun without Redis, by using bunqueue’s built-in Queue/Worker, persistence, and operational controls.

Core Features & Use Cases

  • Choose the right processing mode: embedded for single-process apps, TCP for distributed producer/consumer, and Simple Mode via Bunqueue for quick setup.
  • Run production-ready job workflows: retries, circuit breaking, TTL expiry, cancellation, batching, and priority aging to prevent starvation.
  • Operate and integrate with tools: DLQ for dead-letter handling, cron/interval scheduling, webhooks for job events, and an MCP server with agent tools.

Quick Start

Create an embedded queue and worker that processes email-sending jobs by telling the AI: "Set up bunqueue in embedded mode for the queue 'emails' with a job processor that sends to job.data.to, then add a job named 'send' with {to:'[email protected]'} and show the minimal TypeScript code."

Frequently Asked Questions about bunqueue

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

FAQPage Schema
How do I set up a job queue in Bun without Redis?

You can set up a job queue in Bun without Redis by using bunqueue with persistent SQLite storage to run background tasks reliably. It supports embedded single-process apps and distributed TCP producer/consumer deployments for queue processing.

What is the best way to handle background task retries and dead-letter queues in Bun?

The best way to handle background task retries and dead-letter queues in Bun is using bunqueue's built-in operational controls. It provides automatic DLQ handling, circuit breaking, and TTL expiry to manage failed jobs reliably within SQLite storage.

Can I schedule cron jobs and interval tasks using SQLite in a Bun application?

Yes, you can schedule cron jobs and interval tasks in a Bun application using bunqueue. It supports cron and interval scheduling natively with SQLite persistence, alongside webhook integrations for job events.

Does bunqueue support job dependencies and rate limiting for AI agent workflows?

Yes, bunqueue supports AI-agent-driven workflows needing scheduling and operational monitoring. It includes FlowProducer dependencies for job chaining, alongside deduplication, debouncing, and rate limiting to control job execution flow.

How do I prevent job starvation when prioritizing background tasks in Bun?

To prevent job starvation when prioritizing background tasks in Bun, bunqueue implements priority aging. This feature gradually increases the priority of waiting jobs, ensuring lower-priority tasks eventually process alongside high-priority ones.