Cron Tasks

djs-core provides a built-in scheduler for running code at fixed intervals. Useful for cleanup jobs, daily messages, or any background processing.

export default defineConfig({
  // ...
  experimental: {
    cron: true,
  },
});

Creating a task

Create a file in src/cron/. Each file exports a default Task instance.

import { Task } from "@djs-core/runtime";

export default new Task()
  .cron("0 * * * *") // Every hour
  .run((client) => {
    console.log("Starting hourly cleanup...");
    // cleanup logic here
  });

Cron expression reference

Key methods

• .cron("expression") — standard 5-field cron expression
• .run((client) => { ... }) — receives the Discord client instance