mcpField
C
convex-crons

convex-crons

github.com/convexDevelopment6937.1k installsUpdated 1d ago
Repository

About convex-crons

A skill for adding scheduled jobs to Convex projects. It defines recurring jobs in convex/crons.ts, schedules internal functions, and checks that jobs appear in the dashboard schedule.

Key features

  1. 01Creates recurring jobs in convex/crons.ts
  2. 02Schedules internal functions
  3. 03Uses small, idempotent handlers
  4. 04Checks the dashboard schedule

Use cases

  1. 01Running recurring backend maintenance
  2. 02Scheduling periodic internal tasks
  3. 03Avoiding polling when subscriptions can push updates

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/convex/agent-skills --skill convex-crons

After installing, type/convex-cronsin Claude Code to confirm it loaded.

Details

From the project README

Add scheduled jobs (crons)

Define recurring jobs in convex/crons.ts targeting internal functions, with sane intervals and idempotent handlers.

Workflow

  1. Create convex/crons.ts with cronJobs().
  2. Schedule internal functions (never public api.*) at the right interval.
  3. Make handlers idempotent (safe to re-run); keep each run small.
  4. Verify the job appears in the dashboard schedule.

Rules

  • Schedule internal.* functions, never api.*.
  • Keep cron handlers small + idempotent.
  • Don't poll tight intervals for things a subscription can push.

Comments

Markdown supported