# breejs/bree

Bree is a Node.js and JavaScript job task scheduler with worker threads, cron, Date, and human syntax. Built for @ladjs, @forwardemail, @spamscanner, @cabinjs.

Repository: https://github.com/breejs/bree
Canonical: https://ross.abutalabs.com/products/bree
Homepage: https://jobscheduler.net
Language: JavaScript
License: MIT
License Family: permissive
Topics: job, scheduler, node, cron, ms, human, simple, workers, sandboxed, processes, retries, throttling, concurrency, crontab, cronjob, cancelable, jobs
Last push: 2026-02-17T22:09:07+00:00

## Health v2 (maintenance only)
Score: 75/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 68, release rhythm 71, longevity 100
- inputs: {"age_days": 2247, "days_push": 197, "days_rel": 197, "gap_med": 18.0, "n_releases_24m": 5}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3293, forks 88 (observed 2026-08-28T04:07:53.987532+00:00)

## What it is
Bree is a job/task scheduler library for Node.js and JavaScript supporting cron, Date, ms, and human-readable interval syntax. It runs jobs in sandboxed worker threads with support for retries, throttling, concurrency limits, and cancelable jobs with graceful shutdown.

## Use cases
- schedule cron jobs in node.js
- run background tasks on a schedule
- run jobs in worker threads
- retry failed scheduled jobs
- limit concurrent job execution
- schedule jobs with human-readable intervals

## When to choose
- you need a lightweight, dependency-light scheduler for Node.js
- you want jobs isolated in worker threads
- you need cron, interval, and date-based scheduling in one library

## When to avoid
- you need a distributed scheduler across multiple servers or a persistent job queue
- you're not using Node.js or JavaScript
- you need complex workflow orchestration with dependencies between jobs

## Facets
- artifact type: library
- maturity: active
- function: scheduling, concurrency, workflow-automation
- domain: developer-tools, backend
- platform: -
- tags: job-scheduler, cron, worker-threads, task-runner, background-jobs, automation, nodejs, javascript

## Member repositories
- breejs/bree (main) score 75

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:53.987532+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:22:44.234714+00:00, confidence not recorded.
  - readme: https://github.com/breejs/bree (fetched 2026-08-28T04:07:53.987532+00:00, sha adfb97c482fc)
  - homepage: https://jobscheduler.net (fetched 2026-08-29T09:35:51.432207+00:00, sha b649906674f8)
- Data as of 2026-08-30T08:39:29.467469+00:00.