mcpField
C
convex-crons

convex-crons

github.com/get-convexDevelopment6931.2k installsUpdated 1d ago
Repository

About convex-crons

convex-crons is a skill for Convex developers configuring scheduled jobs. It covers defining schedules, targeting internal functions, and keeping handlers small and safe to rerun.

Key features

  1. 01Define schedules in convex/crons.ts
  2. 02Schedule internal functions
  3. 03Write idempotent handlers
  4. 04Check schedules in the dashboard

Use cases

  1. 01Run internal functions on a schedule
  2. 02Make repeated job runs safe

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/get-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