mcpField
C
cron-jobs

cron-jobs

github.com/rivet-devDevelopment441.2k installsUpdated 1d ago
Repository

About cron-jobs

cron-jobs is a RivetKit skill covering durable actor-local schedules and recurring jobs. It explains schedule selection, cancellation, updates, failure handling, and examples for global or per-entity tasks.

Key features

  1. 01One-time delayed and timed schedules
  2. 02Calendar and interval cron jobs
  3. 03Durable actor-local timers
  4. 04Schedule cancellation and updates
  5. 05Failure and idempotency guidance
  6. 06Scheduling examples

Use cases

  1. 01Scheduling a one-time actor action
  2. 02Running recurring background jobs
  3. 03Creating per-user reminders
  4. 04Managing global scheduled tasks

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/rivet-dev/skills --skill cron-jobs

After installing, type/cron-jobsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

BASE_SKILL.md
index.json
openapi.json
reference/actors/
access-control.md
actions.md
actor-runtime-socket.md
appearance.md
authentication.md
communicating-between-actors.md
connections.md
debugging.md
design-patterns.md
destroy.md
errors.md
events.md
fetch-and-websocket-handler.md
helper-types.md
http-api.md
input.md
inspector-tabs.md
keys.md
kv.md
lifecycle.md
limits.md
metadata.md
queues.md
reference/actors/quickstart/
backend.md
cloudflare.md
effect.md
next-js.md

Details

From the project README

Cron Jobs and Scheduled Tasks

IMPORTANT: Before doing anything, you MUST read BASE_SKILL.md in this skill's directory. It contains essential guidance on debugging, error handling, state management, deployment, and project setup. Those rules and patterns apply to all RivetKit work. Everything below assumes you have already read and understood it.

Working Examples

If you need a reference implementation, read the raw working example code in these templates:

Rivet Actor schedules are durable actor-local timers. They survive actor sleep, restarts, upgrades, deploys, and crashes without a separate cron service.

Choose a schedule type

APIUse it for
c.schedule.after(delayMs, action, ...args)One-time work after a relative delay.
c.schedule.at(timestamp, action, ...args)One-time work at an exact Unix timestamp in milliseconds.
c.cron.set({ ... })Named calendar recurrence in an IANA timezone.
c.cron.every({ ... })Named fixed intervals of at least 5 seconds.

All callbacks are ordinary actions on the same actor. Keep the action name fixed in your code rather than accepting an arbitrary action name from a client.

See Schedule & Cron for the full API, history, cancellation, failure behavior, and limits.

Calendar job

Use cron.set instead of manually re-arming a one-shot action:

Install fixed background jobs in onCreate so setup runs once per actor. The job name remains an upsert key, so a later cron.set call updates the existing job rather than creating a duplicate. cron.set also handles timezone and daylight-saving transitions.

Fixed-interval job

Use cron.every for frequent work such as presence sweeps or cache refreshes:

await c.cron.every({
  name: "presence-sweep",
	interval: 15_000, // Minimum 5 seconds.
  action: "sweepPresence",
  maxHistory: 25,
});

Intervals remain anchored to scheduled deadlines rather than drifting by the action's runtime. If a previous run is still active, the overlapping occurrence is skipped.

Cancellation and updates

Keep the ID returned by a one-shot schedule when it may need cancellation:

const id = await c.schedule.after(60_000, "expireSession", sessionId);
await c.schedule.cancel(id);

Recurring jobs are managed by name:

await c.cron.delete("presence-sweep");

Calling cron.set or cron.every again with the same name replaces its configuration.

Failure and idempotency

Keep scheduled actions idempotent when duplicate work would be harmful. See Execution behavior for retry behavior and workflow guidance.

Topology

Use a singleton actor key for one global job, such as jobs["daily-report"]. Use an actor per user or resource for isolated reminders, trials, billing periods, or other per-entity schedules.

Reference Map

Actors
Cli
Clients
Cookbook
Deploy
General
Self Hosting

Comments

Markdown supported