Skip to content

trigger.dev dev

Run your tasks locally with hot-reloading.

Usage

bash
npx trigger.dev@latest dev [options]

What It Does

  • Starts a local server for your tasks
  • Watches /trigger directory for changes
  • Auto-registers tasks with the Trigger.dev platform
  • Runs each task in a separate process
  • Shows real-time logs and links to run dashboard
  • Auto-cancels runs when the dev server stops

Options

FlagDescription
-c, --configPath to config file
-p, --project-refProject reference
--env-filePath to env file to load
--skip-update-checkSkip checking for package updates
--analyzeOutput timing info for each task file

Example

bash
npx trigger.dev@latest dev
npx trigger.dev@latest dev --env-file .env.local
npx trigger.dev@latest dev --project-ref proj_abc123

Dev vs Production

The dev server uses the same build system as production but runs task code locally. All scheduling is done in the Trigger.dev cloud, but execution happens on your machine — allowing you to use debuggers and breakpoints.

Built from official Trigger.dev documentation