# sidekiq-scheduler/sidekiq-scheduler

Lightweight job scheduler extension for Sidekiq

Repository: https://github.com/sidekiq-scheduler/sidekiq-scheduler
Canonical: https://ross.abutalabs.com/products/sidekiq-scheduler
Homepage: https://sidekiq-scheduler.github.io/sidekiq-scheduler/
Language: Ruby
License: MIT
License Family: permissive
Topics: ruby, sidekiq, cron, scheduler
Last push: 2026-08-11T13:19:51+00:00

## Health v2 (maintenance only)
Score: 83/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 97, release rhythm 56, longevity 100
- inputs: {"age_days": 5287, "days_push": 22, "days_rel": 138, "gap_med": 169.5, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1754, forks 240 (observed 2026-08-28T04:05:32.015411+00:00)

## What it is
A Ruby gem that extends Sidekiq with scheduled job execution, mimicking cron. Jobs are configured via YAML using cron expressions or interval syntax and pushed to Sidekiq queues at the specified times.

## Use cases
- run background jobs on a cron schedule in Rails
- schedule a Sidekiq worker to run every day at 8pm
- replace crontab with Sidekiq-based scheduled jobs
- run recurring cleanup tasks hourly
- schedule jobs with cron syntax in a Ruby app

## When to choose
- you already use Sidekiq and need periodic or cron-scheduled jobs
- you want scheduling configured declaratively in YAML
- you need dynamic schedules managed at runtime

## When to avoid
- you don't use Sidekiq or Redis
- you need a standalone cron replacement outside a Ruby job system
- you need sub-second precision scheduling

## Facets
- artifact type: library
- maturity: active
- function: scheduling, workflow-automation, middleware
- domain: backend, developer-tools
- platform: ruby
- tags: sidekiq, cron, background-jobs, job-scheduler, redis, ruby-gem, automation, linux, macos, docker

## Member repositories
- sidekiq-scheduler/sidekiq-scheduler (main) score 83

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:32.015411+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-30T03:28:08.850936+00:00, confidence not recorded.
  - readme: https://github.com/sidekiq-scheduler/sidekiq-scheduler (fetched 2026-08-28T04:05:32.015411+00:00, sha 516b72c51a8c)
  - homepage: https://sidekiq-scheduler.github.io/sidekiq-scheduler/ (fetched 2026-08-29T11:06:10.195130+00:00, sha 8c0de8c88327)
- Data as of 2026-08-30T08:39:29.467469+00:00.