From d36b7cba6c542638f5751346239b44c576f2b38a Mon Sep 17 00:00:00 2001 From: D-K-P <8297864+D-K-P@users.noreply.github.com> Date: Mon, 18 Aug 2025 11:18:43 +0100 Subject: [PATCH 01/15] readme wip --- packages/trigger-sdk/README.md | 254 +++++++++++++++++++++++++++++++-- 1 file changed, 240 insertions(+), 14 deletions(-) diff --git a/packages/trigger-sdk/README.md b/packages/trigger-sdk/README.md index c53b5cb906..c4a2679eeb 100644 --- a/packages/trigger-sdk/README.md +++ b/packages/trigger-sdk/README.md @@ -4,31 +4,257 @@ Trigger.dev logo - -### Open source background jobs with no timeouts -[Discord](https://trigger.dev/discord) | [Website](https://trigger.dev) | [Issues](https://github.com/triggerdotdev/trigger.dev/issues) | [Docs](https://trigger.dev/docs) +# Official TypeScript SDK for Trigger.dev + +### 🤖 TypeScript SDK for building AI agents & workflows -[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/triggerdotdev.svg?style=social&label=Follow%20%40trigger.dev)](https://twitter.com/triggerdotdev) +[![npm version](https://img.shields.io/npm/v/@trigger.dev/sdk.svg)](https://www.npmjs.com/package/@trigger.dev/sdk) +[![npm downloads](https://img.shields.io/npm/dm/@trigger.dev/sdk.svg)](https://www.npmjs.com/package/@trigger.dev/sdk) +[![GitHub stars](https://img.shields.io/github/stars/triggerdotdev/trigger.dev?style=social)](https://github.com/triggerdotdev/trigger.dev) +[![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](https://www.typescriptlang.org/) +[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) +[![Open Source](https://img.shields.io/badge/Open%20Source-%E2%9D%A4-red)](https://github.com/triggerdotdev/trigger.dev) + +[Discord](https://trigger.dev/discord) | [Website](https://trigger.dev) | [Issues](https://github.com/triggerdotdev/trigger.dev/issues) | [Docs](https://trigger.dev/docs) | [Examples](https://trigger.dev/docs/examples) -# Official TypeScript SDK for Trigger.dev +The **Trigger.dev SDK** enables you to create reliable, long-running AI agents and workflows in your TypeScript applications. Connect to the Trigger.dev platform (cloud or self-hosted) to execute jobs without timeouts, with built-in retries and monitoring. + +## ✨ What you get with this SDK + +- **Write normal async code** - No special syntax, just regular TypeScript functions +- **No timeouts** - Tasks can run for hours or days without failing +- **Built-in reliability** - Automatic retries, error handling, and durable execution +- **Real-time observability** - Watch your tasks execute with full OpenTelemetry tracing +- **Local development** - Test and debug tasks locally with the same environment +- **Checkpoint-resume system** - Efficient resource usage with automatic state management +- **50+ integrations** - Pre-built connectors for AI, databases, and external services +- **Framework agnostic** - Works with Next.js, Express, Fastify, Remix, and more + +## 🚀 Quick Start + +### Installation + +```bash +npm install @trigger.dev/sdk +# or +yarn add @trigger.dev/sdk +# or +pnpm add @trigger.dev/sdk +``` + +### Basic Usage + +```typescript +import { TriggerClient, eventTrigger } from "@trigger.dev/sdk"; + +const client = new TriggerClient({ + id: "my-app", + apiKey: process.env.TRIGGER_API_KEY!, +}); + +// Define a background task - just normal async code +export const generateContent = task({ + id: "generate-content", + retry: { + maxAttempts: 3, + }, + run: async ({ theme, description }: { theme: string; description: string }) => { + // Generate text with OpenAI + const textResult = await openai.chat.completions.create({ + model: "gpt-4o", + messages: [{ role: "user", content: `Create content about ${theme}: ${description}` }], + }); + + if (!textResult.choices[0]) { + throw new Error("No content generated, retrying..."); + } + + // Generate an image + const imageResult = await openai.images.generate({ + model: "dall-e-3", + prompt: `Create an image for: ${theme}`, + }); + + if (!imageResult.data[0]) { + throw new Error("No image generated, retrying..."); + } + + return { + text: textResult.choices[0].message.content, + image: imageResult.data[0].url, + }; + }, +}); + +// Trigger the task from your app +import { tasks } from "@trigger.dev/sdk/v3"; + +const handle = await tasks.trigger("generate-content", { + theme: "AI automation", + description: "How AI is transforming business workflows", +}); +``` + +### Scheduled Tasks & Workflows + +```typescript +import { schedules } from "@trigger.dev/sdk/v3"; + +// Scheduled task - runs every Monday at 9 AM +export const weeklyReport = schedules.task({ + id: "weekly-report", + cron: "0 9 * * MON", + run: async () => { + // Multi-step workflow with automatic retries + const data = await analyzeMetrics.triggerAndWait({ + timeframe: "week", + }); + + const report = await generateReport.triggerAndWait({ + data: data.output, + format: "pdf", + }); + + // Send to team - runs in parallel + await Promise.all([ + sendEmail.trigger({ + to: "team@company.com", + subject: "Weekly Report", + attachment: report.output.url, + }), + uploadToS3.trigger({ + file: report.output, + bucket: "reports", + }), + ]); + + return { success: true, reportId: report.output.id }; + }, +}); +``` + +## 📚 Documentation + +- **[Getting Started Guide](https://trigger.dev/docs/introduction)** - Complete setup walkthrough +- **[API Reference](https://trigger.dev/docs/sdk/introduction)** - Detailed API documentation +- **[Examples](https://trigger.dev/docs/examples)** - Real-world examples and use cases +- **[Integrations](https://trigger.dev/docs/integrations)** - Pre-built integrations catalog +- **[Best Practices](https://trigger.dev/docs/guides/best-practices)** - Production tips and patterns -The Trigger.dev SDK is a TypeScript/JavaScript library that allows you to define and trigger tasks in your project. +## 🔧 Framework Support -## About +Trigger.dev works seamlessly with popular frameworks: -Trigger.dev is an open source platform and SDK which allows you to create long-running background jobs. Write normal async code, deploy, and never hit a timeout. +- **[Next.js](https://trigger.dev/docs/guides/frameworks/nextjs)** - App Router and Pages Router +- **[Express](https://trigger.dev/docs/guides/frameworks/express)** - Traditional Node.js apps +- **[Fastify](https://trigger.dev/docs/guides/frameworks/fastify)** - High-performance web framework +- **[Remix](https://trigger.dev/docs/guides/frameworks/remix)** - Full-stack web framework +- **[NestJS](https://trigger.dev/docs/guides/frameworks/nestjs)** - Enterprise Node.js framework -## Getting started +## 🧩 Popular Integrations -The quickest way to get started is to create an account in our [web app](https://cloud.trigger.dev), create a new project and follow the instructions in the onboarding. Build and deploy your first task in minutes. +```typescript +// Use any npm package - no special integrations needed +import OpenAI from "openai"; +import { PrismaClient } from "@prisma/client"; +import { Resend } from "resend"; -## SDK usage +export const processWithAI = task({ + id: "process-with-ai", + run: async ({ input }: { input: string }) => { + // OpenAI + const openai = new OpenAI(); + const completion = await openai.chat.completions.create({ + model: "gpt-4o", + messages: [{ role: "user", content: input }], + }); -For more information on our SDK, refer to our [docs](https://trigger.dev/docs/introduction). + // Database + const prisma = new PrismaClient(); + await prisma.result.create({ + data: { content: completion.choices[0].message.content }, + }); -## Support + // Email + const resend = new Resend(); + await resend.emails.send({ + from: "noreply@example.com", + to: "user@example.com", + subject: "Processing Complete", + text: completion.choices[0].message.content, + }); -If you have any questions, please reach out to us on [Discord](https://trigger.dev/discord) and we'll be happy to help. + return { success: true }; + }, +}); +``` + +## 🏃‍♂️ Getting Started + +### 1. Install the SDK + +```bash +npm install @trigger.dev/sdk +``` + +### 2. Set up your project + +```bash +npx @trigger.dev/cli@latest init +``` + +### 3. Connect to Trigger.dev + +Choose your deployment option: + +- **[Trigger.dev Cloud](https://cloud.trigger.dev)** - Managed service (recommended) +- **[Self-hosted](https://trigger.dev/docs/self-hosting)** - Deploy on your infrastructure + +### 4. Deploy your jobs + +```bash +npx @trigger.dev/cli@latest deploy +``` + +Or follow our comprehensive [Getting Started Guide](https://trigger.dev/docs/introduction). + +## 💡 Example Tasks + +Check out our [examples repository](https://github.com/triggerdotdev/trigger.dev/tree/main/examples) for production-ready workflows: + +- [AI agents & workflows](https://trigger.dev/docs/examples) - Build invincible AI agents with tools and memory +- [Video processing with FFmpeg](https://trigger.dev/docs/examples/ffmpeg) - Process videos without timeouts +- [PDF generation & processing](https://trigger.dev/docs/examples) - Convert documents at scale +- [Email campaigns](https://trigger.dev/docs/examples) - Multi-step email automation +- [Data pipelines](https://trigger.dev/docs/examples) - ETL processes and database sync +- [Web scraping](https://trigger.dev/docs/examples) - Scrape websites with Puppeteer + +## 🤝 Community & Support + +- **[Discord Community](https://trigger.dev/discord)** - Get help and share ideas +- **[GitHub Issues](https://github.com/triggerdotdev/trigger.dev/issues)** - Bug reports and feature requests +- **[Twitter](https://twitter.com/triggerdotdev)** - Latest updates and news +- **[Blog](https://trigger.dev/blog)** - Tutorials and best practices + +## 📦 Related Packages + +- **[@trigger.dev/cli](https://www.npmjs.com/package/@trigger.dev/cli)** - Command line interface +- **[@trigger.dev/react-hooks](https://www.npmjs.com/package/@trigger.dev/react-hooks)** - React hooks for real-time job monitoring +- **[@trigger.dev/nextjs](https://www.npmjs.com/package/@trigger.dev/nextjs)** - Next.js specific utilities + +## 📄 License + +MIT License - see the [LICENSE](https://github.com/triggerdotdev/trigger.dev/blob/main/LICENSE) file for details. + +## ⭐ Contributing + +We love contributions! Please see our [Contributing Guide](https://github.com/triggerdotdev/trigger.dev/blob/main/CONTRIBUTING.md) for details on how to get started. + +--- + +
+ Built with ❤️ by the Trigger.dev team +
From 79e38e0db4622da8f0b31c9a0869e858d5f46217 Mon Sep 17 00:00:00 2001 From: D-K-P <8297864+D-K-P@users.noreply.github.com> Date: Mon, 18 Aug 2025 11:28:30 +0100 Subject: [PATCH 02/15] Added new commands --- packages/cli-v3/README.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/packages/cli-v3/README.md b/packages/cli-v3/README.md index d7fba79d54..c2c47f5be1 100644 --- a/packages/cli-v3/README.md +++ b/packages/cli-v3/README.md @@ -17,6 +17,9 @@ Trigger.dev is an open source platform that makes it easy to create event-driven | [whoami](https://trigger.dev/docs/cli-whoami-commands) | Display the current logged in user and project details. | | [logout](https://trigger.dev/docs/cli-logout-commands) | Logout of Trigger.dev. | | [list-profiles](https://trigger.dev/docs/cli-list-profiles-commands) | List all of your CLI profiles. | +| [preview archive](https://trigger.dev/docs/cli-preview-archive) | Archive a preview branch. | +| [promote](https://trigger.dev/docs/cli-promote-commands) | Promote a previously deployed version to the current version. | +| [switch](https://trigger.dev/docs/cli-switch) | Switch between CLI profiles. | | [update](https://trigger.dev/docs/cli-update-commands) | Updates all `@trigger.dev/*` packages to match the CLI version. | ## MCP Server From e9d0b259ddc6bbf307743e9ff80318fb39f22071 Mon Sep 17 00:00:00 2001 From: D-K-P <8297864+D-K-P@users.noreply.github.com> Date: Mon, 18 Aug 2025 11:37:41 +0100 Subject: [PATCH 03/15] Simplified readme --- packages/trigger-sdk/README.md | 243 ++------------------------------- 1 file changed, 10 insertions(+), 233 deletions(-) diff --git a/packages/trigger-sdk/README.md b/packages/trigger-sdk/README.md index c4a2679eeb..a82ace1755 100644 --- a/packages/trigger-sdk/README.md +++ b/packages/trigger-sdk/README.md @@ -5,10 +5,6 @@ Trigger.dev logo -# Official TypeScript SDK for Trigger.dev - -### 🤖 TypeScript SDK for building AI agents & workflows - [![npm version](https://img.shields.io/npm/v/@trigger.dev/sdk.svg)](https://www.npmjs.com/package/@trigger.dev/sdk) [![npm downloads](https://img.shields.io/npm/dm/@trigger.dev/sdk.svg)](https://www.npmjs.com/package/@trigger.dev/sdk) [![GitHub stars](https://img.shields.io/github/stars/triggerdotdev/trigger.dev?style=social)](https://github.com/triggerdotdev/trigger.dev) @@ -20,241 +16,22 @@ -The **Trigger.dev SDK** enables you to create reliable, long-running AI agents and workflows in your TypeScript applications. Connect to the Trigger.dev platform (cloud or self-hosted) to execute jobs without timeouts, with built-in retries and monitoring. - -## ✨ What you get with this SDK - -- **Write normal async code** - No special syntax, just regular TypeScript functions -- **No timeouts** - Tasks can run for hours or days without failing -- **Built-in reliability** - Automatic retries, error handling, and durable execution -- **Real-time observability** - Watch your tasks execute with full OpenTelemetry tracing -- **Local development** - Test and debug tasks locally with the same environment -- **Checkpoint-resume system** - Efficient resource usage with automatic state management -- **50+ integrations** - Pre-built connectors for AI, databases, and external services -- **Framework agnostic** - Works with Next.js, Express, Fastify, Remix, and more - -## 🚀 Quick Start - -### Installation - -```bash -npm install @trigger.dev/sdk -# or -yarn add @trigger.dev/sdk -# or -pnpm add @trigger.dev/sdk -``` - -### Basic Usage - -```typescript -import { TriggerClient, eventTrigger } from "@trigger.dev/sdk"; - -const client = new TriggerClient({ - id: "my-app", - apiKey: process.env.TRIGGER_API_KEY!, -}); - -// Define a background task - just normal async code -export const generateContent = task({ - id: "generate-content", - retry: { - maxAttempts: 3, - }, - run: async ({ theme, description }: { theme: string; description: string }) => { - // Generate text with OpenAI - const textResult = await openai.chat.completions.create({ - model: "gpt-4o", - messages: [{ role: "user", content: `Create content about ${theme}: ${description}` }], - }); - - if (!textResult.choices[0]) { - throw new Error("No content generated, retrying..."); - } - - // Generate an image - const imageResult = await openai.images.generate({ - model: "dall-e-3", - prompt: `Create an image for: ${theme}`, - }); - - if (!imageResult.data[0]) { - throw new Error("No image generated, retrying..."); - } - - return { - text: textResult.choices[0].message.content, - image: imageResult.data[0].url, - }; - }, -}); - -// Trigger the task from your app -import { tasks } from "@trigger.dev/sdk/v3"; - -const handle = await tasks.trigger("generate-content", { - theme: "AI automation", - description: "How AI is transforming business workflows", -}); -``` - -### Scheduled Tasks & Workflows - -```typescript -import { schedules } from "@trigger.dev/sdk/v3"; - -// Scheduled task - runs every Monday at 9 AM -export const weeklyReport = schedules.task({ - id: "weekly-report", - cron: "0 9 * * MON", - run: async () => { - // Multi-step workflow with automatic retries - const data = await analyzeMetrics.triggerAndWait({ - timeframe: "week", - }); - - const report = await generateReport.triggerAndWait({ - data: data.output, - format: "pdf", - }); - - // Send to team - runs in parallel - await Promise.all([ - sendEmail.trigger({ - to: "team@company.com", - subject: "Weekly Report", - attachment: report.output.url, - }), - uploadToS3.trigger({ - file: report.output, - bucket: "reports", - }), - ]); - - return { success: true, reportId: report.output.id }; - }, -}); -``` - -## 📚 Documentation - -- **[Getting Started Guide](https://trigger.dev/docs/introduction)** - Complete setup walkthrough -- **[API Reference](https://trigger.dev/docs/sdk/introduction)** - Detailed API documentation -- **[Examples](https://trigger.dev/docs/examples)** - Real-world examples and use cases -- **[Integrations](https://trigger.dev/docs/integrations)** - Pre-built integrations catalog -- **[Best Practices](https://trigger.dev/docs/guides/best-practices)** - Production tips and patterns - -## 🔧 Framework Support - -Trigger.dev works seamlessly with popular frameworks: - -- **[Next.js](https://trigger.dev/docs/guides/frameworks/nextjs)** - App Router and Pages Router -- **[Express](https://trigger.dev/docs/guides/frameworks/express)** - Traditional Node.js apps -- **[Fastify](https://trigger.dev/docs/guides/frameworks/fastify)** - High-performance web framework -- **[Remix](https://trigger.dev/docs/guides/frameworks/remix)** - Full-stack web framework -- **[NestJS](https://trigger.dev/docs/guides/frameworks/nestjs)** - Enterprise Node.js framework - -## 🧩 Popular Integrations - -```typescript -// Use any npm package - no special integrations needed -import OpenAI from "openai"; -import { PrismaClient } from "@prisma/client"; -import { Resend } from "resend"; - -export const processWithAI = task({ - id: "process-with-ai", - run: async ({ input }: { input: string }) => { - // OpenAI - const openai = new OpenAI(); - const completion = await openai.chat.completions.create({ - model: "gpt-4o", - messages: [{ role: "user", content: input }], - }); - - // Database - const prisma = new PrismaClient(); - await prisma.result.create({ - data: { content: completion.choices[0].message.content }, - }); - - // Email - const resend = new Resend(); - await resend.emails.send({ - from: "noreply@example.com", - to: "user@example.com", - subject: "Processing Complete", - text: completion.choices[0].message.content, - }); - - return { success: true }; - }, -}); -``` - -## 🏃‍♂️ Getting Started - -### 1. Install the SDK - -```bash -npm install @trigger.dev/sdk -``` - -### 2. Set up your project - -```bash -npx @trigger.dev/cli@latest init -``` - -### 3. Connect to Trigger.dev - -Choose your deployment option: - -- **[Trigger.dev Cloud](https://cloud.trigger.dev)** - Managed service (recommended) -- **[Self-hosted](https://trigger.dev/docs/self-hosting)** - Deploy on your infrastructure - -### 4. Deploy your jobs - -```bash -npx @trigger.dev/cli@latest deploy -``` - -Or follow our comprehensive [Getting Started Guide](https://trigger.dev/docs/introduction). - -## 💡 Example Tasks - -Check out our [examples repository](https://github.com/triggerdotdev/trigger.dev/tree/main/examples) for production-ready workflows: - -- [AI agents & workflows](https://trigger.dev/docs/examples) - Build invincible AI agents with tools and memory -- [Video processing with FFmpeg](https://trigger.dev/docs/examples/ffmpeg) - Process videos without timeouts -- [PDF generation & processing](https://trigger.dev/docs/examples) - Convert documents at scale -- [Email campaigns](https://trigger.dev/docs/examples) - Multi-step email automation -- [Data pipelines](https://trigger.dev/docs/examples) - ETL processes and database sync -- [Web scraping](https://trigger.dev/docs/examples) - Scrape websites with Puppeteer - -## 🤝 Community & Support +# Official TypeScript SDK for Trigger.dev -- **[Discord Community](https://trigger.dev/discord)** - Get help and share ideas -- **[GitHub Issues](https://github.com/triggerdotdev/trigger.dev/issues)** - Bug reports and feature requests -- **[Twitter](https://twitter.com/triggerdotdev)** - Latest updates and news -- **[Blog](https://trigger.dev/blog)** - Tutorials and best practices +The Trigger.dev SDK is a TypeScript/JavaScript library that allows you to define and trigger tasks in your project. -## 📦 Related Packages +## About Trigger.dev -- **[@trigger.dev/cli](https://www.npmjs.com/package/@trigger.dev/cli)** - Command line interface -- **[@trigger.dev/react-hooks](https://www.npmjs.com/package/@trigger.dev/react-hooks)** - React hooks for real-time job monitoring -- **[@trigger.dev/nextjs](https://www.npmjs.com/package/@trigger.dev/nextjs)** - Next.js specific utilities +Trigger.dev is a platform for building and deploying fully-managed AI agents and workflows. Write workflows in normal async TypeScript for everything from simple tasks to long-running AI agents, heavy media processing, complex real-time systems and more. Complete with trace visibility, managed queues, and elastic infrastructure which handles the horizontal scaling. -## 📄 License +## Getting started -MIT License - see the [LICENSE](https://github.com/triggerdotdev/trigger.dev/blob/main/LICENSE) file for details. +The quickest way to get started is to create an account in our [web app](https://cloud.trigger.dev), create a new project and follow the instructions in the onboarding. Build and deploy your first task in minutes. -## ⭐ Contributing +## SDK usage -We love contributions! Please see our [Contributing Guide](https://github.com/triggerdotdev/trigger.dev/blob/main/CONTRIBUTING.md) for details on how to get started. +For more information on our SDK, refer to our [docs](https://trigger.dev/docs/introduction). ---- +## Support -
- Built with ❤️ by the Trigger.dev team -
+If you have any questions, please reach out to us on [Discord](https://trigger.dev/discord) and we'll be happy to help. From 7424e1a19db143499d9f2be042681bce19d0bdd3 Mon Sep 17 00:00:00 2001 From: D-K-P <8297864+D-K-P@users.noreply.github.com> Date: Mon, 18 Aug 2025 11:46:55 +0100 Subject: [PATCH 04/15] Added docs links and improved about --- packages/cli-v3/README.md | 35 +++++----------------------------- packages/trigger-sdk/README.md | 23 +++++++++++++++++++--- 2 files changed, 25 insertions(+), 33 deletions(-) diff --git a/packages/cli-v3/README.md b/packages/cli-v3/README.md index c2c47f5be1..2925e600e4 100644 --- a/packages/cli-v3/README.md +++ b/packages/cli-v3/README.md @@ -4,7 +4,9 @@ A CLI that allows you to create, run locally and deploy Trigger.dev background t Note: this only works with Trigger.dev v3 projects and later. For older projects use the [@trigger.dev/cli](https://www.npmjs.com/package/@trigger.dev/cli) package. -Trigger.dev is an open source platform that makes it easy to create event-driven background tasks directly in your existing project. +## About Trigger.dev + +Trigger.dev is an open source platform for building and deploying fully-managed AI agents and workflows. Write workflows in normal async TypeScript for everything from simple tasks to long-running AI agents, heavy media processing, complex real-time systems and more. Complete with trace visibility, managed queues, and elastic infrastructure which handles the horizontal scaling. ## Commands @@ -22,36 +24,9 @@ Trigger.dev is an open source platform that makes it easy to create event-driven | [switch](https://trigger.dev/docs/cli-switch) | Switch between CLI profiles. | | [update](https://trigger.dev/docs/cli-update-commands) | Updates all `@trigger.dev/*` packages to match the CLI version. | -## MCP Server - -The [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) is an open protocol that allows you to provide custom tools -to agentic LLM clients, like [Claude for Desktop](https://docs.anthropic.com/en/docs/claude-for-desktop/overview), [Cursor](https://www.cursor.com/), [Windsurf](https://windsurf.com/), etc... - -The Trigger.dev CLI can expose an MCP server and enable you interact with Trigger.dev in agentic LLM workflows. For example, you can use -it to trigger tasks via natural language, view task runs, view logs, debug issues with task runs, etc... - -### Starting the Trigger.dev MCP Server - -To start the Trigger.dev MCP server, simply pass the `--mcp` flag to the `dev` command: - -```bash -trigger dev --mcp -``` - -By default it runs on port `3333`. You can change this by passing the `--mcp-port` flag: - -```bash -trigger dev --mcp --mcp-port 3334 -``` - -### Configuring your MCP client - -This depends on what tool you are using. For Cursor, the configuration is in the [.cursor/mcp.json](../../.cursor/mcp.json) file -and should be good to go as long as you use the default MCP server port. - -Check out [Cursor's docs](https://docs.cursor.com/context/model-context-protocol) for further details. +## Documentation -Tip: try out [Cursor's YOLO mode](https://docs.cursor.com/context/model-context-protocol#yolo-mode) for a seamless experience :D +For more information on the CLI, please refer to our [docs](https://trigger.dev/docs/cli-introduction). ## Support diff --git a/packages/trigger-sdk/README.md b/packages/trigger-sdk/README.md index a82ace1755..e4f5bd552c 100644 --- a/packages/trigger-sdk/README.md +++ b/packages/trigger-sdk/README.md @@ -18,15 +18,32 @@ # Official TypeScript SDK for Trigger.dev -The Trigger.dev SDK is a TypeScript/JavaScript library that allows you to define and trigger tasks in your project. +The Trigger.dev SDK is a TypeScript/JavaScript library that allows you to define and trigger tasks in your projects. ## About Trigger.dev -Trigger.dev is a platform for building and deploying fully-managed AI agents and workflows. Write workflows in normal async TypeScript for everything from simple tasks to long-running AI agents, heavy media processing, complex real-time systems and more. Complete with trace visibility, managed queues, and elastic infrastructure which handles the horizontal scaling. +Trigger.dev is an open source platform for building and deploying fully-managed AI agents and workflows. Write workflows in normal async TypeScript for everything from simple tasks to long-running AI agents, heavy media processing, complex real-time systems and more. Complete with trace visibility, managed queues, and elastic infrastructure which handles the horizontal scaling. + +## Core features + +- Task creation and execution +- CLI for development and deployment +- Build system with extensions +- Management API for runs, schedules, and environment variables + +## Key Components: + +- Tasks: Background jobs written in TypeScript/JavaScript +- CLI: Commands for login, init, dev, deploy +- Build Extensions: Customize builds (Prisma, Python, FFmpeg, etc.) +- Management API: Programmatic control over runs and resources ## Getting started -The quickest way to get started is to create an account in our [web app](https://cloud.trigger.dev), create a new project and follow the instructions in the onboarding. Build and deploy your first task in minutes. +There are two ways to get started: + +1. Create an account in our [web app](https://cloud.trigger.dev), create a new project and follow the instructions in the onboarding. Build and deploy your first task in minutes. +2. [Manual setup](https://trigger.dev/docs/manual-setup) in your existing project. ## SDK usage From f24952e8c7d4c6b7049152ae1f568d5dcec2bda9 Mon Sep 17 00:00:00 2001 From: D-K-P <8297864+D-K-P@users.noreply.github.com> Date: Mon, 18 Aug 2025 11:54:24 +0100 Subject: [PATCH 05/15] Added nice header and updated links --- packages/cli-v3/README.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/packages/cli-v3/README.md b/packages/cli-v3/README.md index 2925e600e4..d19bd6d99f 100644 --- a/packages/cli-v3/README.md +++ b/packages/cli-v3/README.md @@ -1,3 +1,21 @@ +
+ + + + Trigger.dev logo + + +[![npm version](https://img.shields.io/npm/v/trigger.dev.svg)](https://www.npmjs.com/package/trigger.dev) +[![npm downloads](https://img.shields.io/npm/dm/trigger.dev.svg)](https://www.npmjs.com/package/trigger.dev) +[![GitHub stars](https://img.shields.io/github/stars/triggerdotdev/trigger.dev?style=social)](https://github.com/triggerdotdev/trigger.dev) +[![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](https://www.typescriptlang.org/) +[![License: ](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) +[![Open Source](https://img.shields.io/badge/Open%20Source-%E2%9D%A4-red)](https://github.com/triggerdotdev/trigger.dev) + +[Discord](https://trigger.dev/discord) | [Website](https://trigger.dev) | [Issues](https://github.com/triggerdotdev/trigger.dev/issues) | [Docs](https://trigger.dev/docs) | [Examples](https://trigger.dev/docs/examples) + +
+ # Trigger.dev CLI A CLI that allows you to create, run locally and deploy Trigger.dev background tasks. From 1c6859dcac40d2fe3d48254f9c7352c0c66a359b Mon Sep 17 00:00:00 2001 From: D-K-P <8297864+D-K-P@users.noreply.github.com> Date: Mon, 18 Aug 2025 11:55:10 +0100 Subject: [PATCH 06/15] Consistent headers --- packages/cli-v3/README.md | 2 +- packages/trigger-sdk/README.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/packages/cli-v3/README.md b/packages/cli-v3/README.md index d19bd6d99f..2cf2af2880 100644 --- a/packages/cli-v3/README.md +++ b/packages/cli-v3/README.md @@ -42,7 +42,7 @@ Trigger.dev is an open source platform for building and deploying fully-managed | [switch](https://trigger.dev/docs/cli-switch) | Switch between CLI profiles. | | [update](https://trigger.dev/docs/cli-update-commands) | Updates all `@trigger.dev/*` packages to match the CLI version. | -## Documentation +## CLI documentation For more information on the CLI, please refer to our [docs](https://trigger.dev/docs/cli-introduction). diff --git a/packages/trigger-sdk/README.md b/packages/trigger-sdk/README.md index e4f5bd552c..01286594c0 100644 --- a/packages/trigger-sdk/README.md +++ b/packages/trigger-sdk/README.md @@ -45,7 +45,7 @@ There are two ways to get started: 1. Create an account in our [web app](https://cloud.trigger.dev), create a new project and follow the instructions in the onboarding. Build and deploy your first task in minutes. 2. [Manual setup](https://trigger.dev/docs/manual-setup) in your existing project. -## SDK usage +## SDK documentation For more information on our SDK, refer to our [docs](https://trigger.dev/docs/introduction). From fa2ac90ef04ab13908b84e08c7ade591913119db Mon Sep 17 00:00:00 2001 From: D-K-P <8297864+D-K-P@users.noreply.github.com> Date: Mon, 18 Aug 2025 12:03:40 +0100 Subject: [PATCH 07/15] Copy update --- packages/cli-v3/README.md | 2 +- packages/trigger-sdk/README.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/packages/cli-v3/README.md b/packages/cli-v3/README.md index 2cf2af2880..84fc2a7911 100644 --- a/packages/cli-v3/README.md +++ b/packages/cli-v3/README.md @@ -24,7 +24,7 @@ Note: this only works with Trigger.dev v3 projects and later. For older projects ## About Trigger.dev -Trigger.dev is an open source platform for building and deploying fully-managed AI agents and workflows. Write workflows in normal async TypeScript for everything from simple tasks to long-running AI agents, heavy media processing, complex real-time systems and more. Complete with trace visibility, managed queues, and elastic infrastructure which handles the horizontal scaling. +Trigger.dev is an open source platform for building and deploying fully-managed AI agents and workflows. Write workflows in normal async TypeScript for everything from simple tasks to long-running AI agents, heavy media processing, complex real-time systems and more. Complete with full observability, managed queues, and elastic infrastructure which handles the horizontal scaling. ## Commands diff --git a/packages/trigger-sdk/README.md b/packages/trigger-sdk/README.md index 01286594c0..f82b525095 100644 --- a/packages/trigger-sdk/README.md +++ b/packages/trigger-sdk/README.md @@ -22,7 +22,7 @@ The Trigger.dev SDK is a TypeScript/JavaScript library that allows you to define ## About Trigger.dev -Trigger.dev is an open source platform for building and deploying fully-managed AI agents and workflows. Write workflows in normal async TypeScript for everything from simple tasks to long-running AI agents, heavy media processing, complex real-time systems and more. Complete with trace visibility, managed queues, and elastic infrastructure which handles the horizontal scaling. +Trigger.dev is an open source platform for building and deploying fully-managed AI agents and workflows. Write workflows in normal async TypeScript for everything from simple tasks to long-running AI agents, heavy media processing, complex real-time systems and more. Complete with full observability, managed queues, and elastic infrastructure which handles the horizontal scaling. ## Core features From ea71e7d57694cb4d010e65be701f20b2235f449f Mon Sep 17 00:00:00 2001 From: D-K-P <8297864+D-K-P@users.noreply.github.com> Date: Wed, 20 Aug 2025 14:26:06 +0100 Subject: [PATCH 08/15] Updated badges --- README.md | 23 ++++++++++++++++------- 1 file changed, 16 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index dab0551dc0..5658ffc141 100644 --- a/README.md +++ b/README.md @@ -5,22 +5,31 @@ Trigger.dev logo -### Open source background jobs and AI infrastructure +### Build and deploy fully‑managed AI agents and workflows -[Discord](https://trigger.dev/discord) | [Website](https://trigger.dev) | [Issues](https://github.com/triggerdotdev/trigger.dev/issues) | [Docs](https://trigger.dev/docs) +[Website](https://trigger.dev) | [Docs](https://trigger.dev/docs) | [Issues](https://github.com/triggerdotdev/trigger.dev/issues) | [Feature requests](https://trigger.dev/feature-requests) | [Roadmap](https://trigger.dev/roadmap) | [Self-hosting](https://trigger.dev/docs/v3/open-source-self-hosting#overview) -[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/triggerdotdev.svg?style=social&label=Follow%20%40trigger.dev)](https://twitter.com/triggerdotdev) +[![GitHub stars](https://img.shields.io/github/stars/triggerdotdev/trigger.dev?style=social)](https://github.com/triggerdotdev/trigger.dev) +[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/triggerdotdev/trigger.dev/blob/main/LICENSE) +[![Open Source](https://img.shields.io/badge/Open%20Source-%E2%9D%A4-red.svg)](https://github.com/triggerdotdev/trigger.dev) +[![npm](https://img.shields.io/npm/v/@trigger.dev/sdk.svg?label=npm)](https://www.npmjs.com/package/@trigger.dev/sdk) +[![SDK downloads](https://img.shields.io/npm/dm/@trigger.dev/sdk.svg?label=SDK%20downloads)](https://www.npmjs.com/package/@trigger.dev/sdk) +[![CLI downloads](https://img.shields.io/npm/dm/trigger.dev.svg?label=CLI%20downloads)](https://www.npmjs.com/package/trigger.dev) +[![GitHub commit activity](https://img.shields.io/github/commit-activity/m/triggerdotdev/trigger.dev)](https://github.com/triggerdotdev/trigger.dev/graphs/contributors) + +[![Twitter Follow](https://img.shields.io/twitter/follow/triggerdotdev?style=social)](https://twitter.com/triggerdotdev) +[![Discord](https://img.shields.io/discord/1066956501299777596?logo=discord&logoColor=white&color=7289da)](https://discord.gg/nkqV9xBYWy) ## About Trigger.dev -Trigger.dev is an open source platform and SDK which allows you to create long-running background jobs. Write normal async code, deploy, and never hit a timeout. +Trigger.dev is the open-source platform for building AI workflows in TypeScript. Long-running tasks with retries, queues, observability, and elastic scaling. ### Key features: - JavaScript and TypeScript SDK -- No timeouts +- Long-running tasks with retries, queues, observability, and elastic scaling - Retries (with exponential backoff) - Queues and concurrency controls - Schedules and crons @@ -38,7 +47,7 @@ Trigger.dev is an open source platform and SDK which allows you to create long-r Create tasks where they belong: in your codebase. Version control, localhost, test and review like you're already used to. ```ts -import { task } from "@trigger.dev/sdk/v3"; +import { task } from "@trigger.dev/sdk"; //1. You need to export each task export const helloWorld = task({ @@ -58,7 +67,7 @@ Use our SDK to write tasks in your codebase. There's no infrastructure to manage ## Environments -We support `Development`, `Staging`, and `Production` environments, allowing you to test your tasks before deploying them to production. +We support `Development`, `Staging`, `Preview`, and `Production` environments, allowing you to test your tasks before deploying them to production. ## Full visibility of every job run From 4e50c309b43b30e62fa2669740161ec272edd174 Mon Sep 17 00:00:00 2001 From: D-K-P <8297864+D-K-P@users.noreply.github.com> Date: Wed, 20 Aug 2025 16:00:27 +0100 Subject: [PATCH 09/15] Added features / agents section --- README.md | 46 +++++++++++++++++++++++++++++----------------- 1 file changed, 29 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index 5658ffc141..cd8580c5b8 100644 --- a/README.md +++ b/README.md @@ -9,13 +9,11 @@ [Website](https://trigger.dev) | [Docs](https://trigger.dev/docs) | [Issues](https://github.com/triggerdotdev/trigger.dev/issues) | [Feature requests](https://trigger.dev/feature-requests) | [Roadmap](https://trigger.dev/roadmap) | [Self-hosting](https://trigger.dev/docs/v3/open-source-self-hosting#overview) -[![GitHub stars](https://img.shields.io/github/stars/triggerdotdev/trigger.dev?style=social)](https://github.com/triggerdotdev/trigger.dev) -[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/triggerdotdev/trigger.dev/blob/main/LICENSE) [![Open Source](https://img.shields.io/badge/Open%20Source-%E2%9D%A4-red.svg)](https://github.com/triggerdotdev/trigger.dev) +[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/triggerdotdev/trigger.dev/blob/main/LICENSE) [![npm](https://img.shields.io/npm/v/@trigger.dev/sdk.svg?label=npm)](https://www.npmjs.com/package/@trigger.dev/sdk) [![SDK downloads](https://img.shields.io/npm/dm/@trigger.dev/sdk.svg?label=SDK%20downloads)](https://www.npmjs.com/package/@trigger.dev/sdk) -[![CLI downloads](https://img.shields.io/npm/dm/trigger.dev.svg?label=CLI%20downloads)](https://www.npmjs.com/package/trigger.dev) -[![GitHub commit activity](https://img.shields.io/github/commit-activity/m/triggerdotdev/trigger.dev)](https://github.com/triggerdotdev/trigger.dev/graphs/contributors) +[![GitHub stars](https://img.shields.io/github/stars/triggerdotdev/trigger.dev?style=social)](https://github.com/triggerdotdev/trigger.dev) [![Twitter Follow](https://img.shields.io/twitter/follow/triggerdotdev?style=social)](https://twitter.com/triggerdotdev) [![Discord](https://img.shields.io/discord/1066956501299777596?logo=discord&logoColor=white&color=7289da)](https://discord.gg/nkqV9xBYWy) @@ -28,19 +26,33 @@ Trigger.dev is the open-source platform for building AI workflows in TypeScript. ### Key features: -- JavaScript and TypeScript SDK -- Long-running tasks with retries, queues, observability, and elastic scaling -- Retries (with exponential backoff) -- Queues and concurrency controls -- Schedules and crons -- Full Observability; logs, live trace views, advanced filtering -- React hooks to interact with the Trigger API from your React app -- Pipe LLM streams straight to your users through the Realtime API -- Trigger tasks and display the run status and metadata anywhere in your app -- Custom alerts, get notified by email, Slack or webhooks -- No infrastructure to manage -- Elastic (scaling) -- Works with your existing tech stack +- **[Perfect for building AI agents](https://trigger.dev/product/ai-agents)** - Build AI agents using all the services and LLMs you already use, like the AI SDK, OpenAI, Anthropic, LangChain, etc. +- **[Write tasks in regular code](https://trigger.dev/docs/guides/introduction)** - Build background tasks using familiar programming models in native Javascript / Typescript and Python +- **[Long-running tasks](https://trigger.dev/product)** - Handle resource-heavy tasks without timeouts +- **[Durable cron schedules](https://trigger.dev/product/scheduled-tasks)** - Create and attach recurring schedules of up to a year, which never hit a function timeout +- **[Trigger.dev Realtime](https://trigger.dev/product/realtime)** - Real-time bridge between your background tasks and frontend applications with streaming support +- **[React hooks](https://trigger.dev/docs/frontend/react-hooks#react-hooks)** - Interact with the Trigger.dev API using our React hooks package +- **[Max duration](https://trigger.dev/docs/runs/max-duration#max-duration)** - Set maximum execution time for tasks to prevent runaway processes +- **[Batch triggering](https://trigger.dev/docs/triggering#tasks-batchtrigger)** - Use batchTrigger() to initiate multiple runs of a task with custom payloads and options +- **[Structured inputs / outputs](https://trigger.dev/docs/tasks/schemaTask#schematask)** - Define precise data schemas for your tasks with runtime payload validation using SchemaTask +- **[Waits](https://trigger.dev/docs/wait)** - Add waits to your tasks to pause execution for a specified duration +- **[Preview branches](https://trigger.dev/docs/deployment/preview-branches)** - Create isolated environments for testing and development. Integrates with Vercel and git workflows +- **[Waitpoints](https://trigger.dev/docs/upgrade-to-v4#wait-tokens)** - Add human judgment at critical decision points without disrupting workflow +- **[Concurrency & queues](https://trigger.dev/product/concurrency-and-queues)** - Set concurrency rules to manage how multiple tasks execute +- **[Multiple environments](https://trigger.dev/docs/how-it-works#dev-mode)** - Support for DEV, PREVIEW, STAGING, and PROD environments +- **[No infrastructure to manage](https://trigger.dev/docs/how-it-works#trigger-dev-architecture)** - Auto-scaling infrastructure that eliminates timeouts and server management +- **[Automatic retries](https://trigger.dev/docs/errors-retrying)** - If your task encounters an uncaught error, we automatically attempt to run it again +- **[Build extensions](https://trigger.dev/docs/config/extensions/overview#build-extensions)** - Hook directly into the build system and customize the build process +- **[Checkpointing](https://trigger.dev/docs/how-it-works#the-checkpoint-resume-system)** - Tasks are inherently durable, thanks to our checkpointing feature +- **[Versioning](https://trigger.dev/docs/versioning)** - Atomic versioning allows you to deploy new versions without affecting running tasks +- **[Machines](https://trigger.dev/docs/machines)** - Configure the number of vCPUs and GBs of RAM you want the task to use +- **[Observability & monitoring](https://trigger.dev/product/observability-and-monitoring)** - Monitor every aspect of your tasks' performance with comprehensive logging and visualization tools +- **[Logging & tracing](https://trigger.dev/docs/logging)** - Comprehensive logging and tracing for all your tasks +- **[Tags](https://trigger.dev/docs/tags#tags)** - Attach up to five tags to each run as powerful identifiers +- **[Advanced run filters](/product/observability-and-monitoring#advanced-filters)** - Easily sort and find tasks based on status, environment, tags, and creation date +- **[Run metadata](https://trigger.dev/docs/runs/metadata#run-metadata)** - Attach metadata to runs which updates as the run progresses +- **[Bulk actions](https://trigger.dev/docs/bulk-actions)** - Perform actions on multiple runs simultaneously, including replaying and cancelling +- **[Real-time alerts](https://trigger.dev/product/observability-and-monitoring#alerts)** - Choose your preferred notification method for run failures and deployments ## In your codebase From a3ad81e3114d3644a23f02e6907b999aaccf99d5 Mon Sep 17 00:00:00 2001 From: D-K-P <8297864+D-K-P@users.noreply.github.com> Date: Wed, 20 Aug 2025 16:04:23 +0100 Subject: [PATCH 10/15] Updated list --- README.md | 36 +++++++++++++++++++++++++----------- 1 file changed, 25 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index cd8580c5b8..4178eaae87 100644 --- a/README.md +++ b/README.md @@ -24,20 +24,34 @@ Trigger.dev is the open-source platform for building AI workflows in TypeScript. Long-running tasks with retries, queues, observability, and elastic scaling. -### Key features: +## The perfect platform for building AI agents + +Build AI agents in familiar programming models using all the services and LLMs you already use, deploy them to Trigger.dev and get durable, long-running tasks with retries, queues, observability, and elastic scaling out of the box. + +- **Long-running without timeouts**: Execute your tasks with absolutely no timeouts, unlike AWS Lambda, Vercel, and other serverless platforms. + +- **Durability, retries & queues**: Build rock solid agents and AI applications using our durable tasks, retries, queues and idempotency. + +- **True runtime freedom**: Customize your deployed tasks with system packages – run browsers, Python scripts, FFmpeg and more. + +- **Human-in-the-loop**: Programmatically pause your tasks until a human can approve, reject or give feedback. + +- **Realtime apps & streaming**: Move your background jobs to the foreground by subscribing to runs or streaming AI responses to your app. + +- **Observability & monitoring**: Each run has full tracing and logs. Configure error alerts to catch bugs fast. Monitor performance with metrics. + +## Key features: -- **[Perfect for building AI agents](https://trigger.dev/product/ai-agents)** - Build AI agents using all the services and LLMs you already use, like the AI SDK, OpenAI, Anthropic, LangChain, etc. - **[Write tasks in regular code](https://trigger.dev/docs/guides/introduction)** - Build background tasks using familiar programming models in native Javascript / Typescript and Python -- **[Long-running tasks](https://trigger.dev/product)** - Handle resource-heavy tasks without timeouts -- **[Durable cron schedules](https://trigger.dev/product/scheduled-tasks)** - Create and attach recurring schedules of up to a year, which never hit a function timeout -- **[Trigger.dev Realtime](https://trigger.dev/product/realtime)** - Real-time bridge between your background tasks and frontend applications with streaming support -- **[React hooks](https://trigger.dev/docs/frontend/react-hooks#react-hooks)** - Interact with the Trigger.dev API using our React hooks package -- **[Max duration](https://trigger.dev/docs/runs/max-duration#max-duration)** - Set maximum execution time for tasks to prevent runaway processes +- **[Long-running tasks](https://trigger.dev/docs/runs/max-duration)** - Handle resource-heavy tasks without timeouts +- **[Durable cron schedules](https://trigger.dev/product/scheduled-tasks)** - Create and attach recurring schedules of up to a year +- **[Trigger.dev Realtime](https://trigger.dev/product/realtime)** - Real-time bridge between your background tasks and frontend applications with LLM streaming support +- **[React hooks](https://trigger.dev/docs/frontend/react-hooks#react-hooks)** - Interact with the Trigger.dev API on your frontend using our React hooks package - **[Batch triggering](https://trigger.dev/docs/triggering#tasks-batchtrigger)** - Use batchTrigger() to initiate multiple runs of a task with custom payloads and options -- **[Structured inputs / outputs](https://trigger.dev/docs/tasks/schemaTask#schematask)** - Define precise data schemas for your tasks with runtime payload validation using SchemaTask +- **[Structured inputs / outputs](https://trigger.dev/docs/tasks/schemaTask#schematask)** - Define precise data schemas for your tasks with runtime payload validation - **[Waits](https://trigger.dev/docs/wait)** - Add waits to your tasks to pause execution for a specified duration - **[Preview branches](https://trigger.dev/docs/deployment/preview-branches)** - Create isolated environments for testing and development. Integrates with Vercel and git workflows -- **[Waitpoints](https://trigger.dev/docs/upgrade-to-v4#wait-tokens)** - Add human judgment at critical decision points without disrupting workflow +- **[Waitpoints](https://trigger.dev/docs/upgrade-to-v4#wait-tokens)** - Add human-in-the-loop judgment at critical decision points without disrupting workflow - **[Concurrency & queues](https://trigger.dev/product/concurrency-and-queues)** - Set concurrency rules to manage how multiple tasks execute - **[Multiple environments](https://trigger.dev/docs/how-it-works#dev-mode)** - Support for DEV, PREVIEW, STAGING, and PROD environments - **[No infrastructure to manage](https://trigger.dev/docs/how-it-works#trigger-dev-architecture)** - Auto-scaling infrastructure that eliminates timeouts and server management @@ -50,11 +64,11 @@ Trigger.dev is the open-source platform for building AI workflows in TypeScript. - **[Logging & tracing](https://trigger.dev/docs/logging)** - Comprehensive logging and tracing for all your tasks - **[Tags](https://trigger.dev/docs/tags#tags)** - Attach up to five tags to each run as powerful identifiers - **[Advanced run filters](/product/observability-and-monitoring#advanced-filters)** - Easily sort and find tasks based on status, environment, tags, and creation date -- **[Run metadata](https://trigger.dev/docs/runs/metadata#run-metadata)** - Attach metadata to runs which updates as the run progresses +- **[Run metadata](https://trigger.dev/docs/runs/metadata#run-metadata)** - Attach metadata to runs which updates as the run progresses and is available to use in your frontend for live updates - **[Bulk actions](https://trigger.dev/docs/bulk-actions)** - Perform actions on multiple runs simultaneously, including replaying and cancelling - **[Real-time alerts](https://trigger.dev/product/observability-and-monitoring#alerts)** - Choose your preferred notification method for run failures and deployments -## In your codebase +## Write tasks in your codebase Create tasks where they belong: in your codebase. Version control, localhost, test and review like you're already used to. From d04dc7b80736036e063ec3082798578262e2b2a4 Mon Sep 17 00:00:00 2001 From: D-K-P <8297864+D-K-P@users.noreply.github.com> Date: Wed, 20 Aug 2025 16:08:45 +0100 Subject: [PATCH 11/15] Added links --- README.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 4178eaae87..2c760f5c4f 100644 --- a/README.md +++ b/README.md @@ -7,16 +7,16 @@ ### Build and deploy fully‑managed AI agents and workflows -[Website](https://trigger.dev) | [Docs](https://trigger.dev/docs) | [Issues](https://github.com/triggerdotdev/trigger.dev/issues) | [Feature requests](https://trigger.dev/feature-requests) | [Roadmap](https://trigger.dev/roadmap) | [Self-hosting](https://trigger.dev/docs/v3/open-source-self-hosting#overview) +[Website](https://trigger.dev) | [Docs](https://trigger.dev/docs) | [Issues](https://github.com/triggerdotdev/trigger.dev/issues) | [Feature requests](https://triggerdev.featurebase.app/) | [Public roadmap](https://triggerdev.featurebase.app/roadmap) | [Self-hosting](https://trigger.dev/docs/self-hosting/overview) [![Open Source](https://img.shields.io/badge/Open%20Source-%E2%9D%A4-red.svg)](https://github.com/triggerdotdev/trigger.dev) [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/triggerdotdev/trigger.dev/blob/main/LICENSE) [![npm](https://img.shields.io/npm/v/@trigger.dev/sdk.svg?label=npm)](https://www.npmjs.com/package/@trigger.dev/sdk) [![SDK downloads](https://img.shields.io/npm/dm/@trigger.dev/sdk.svg?label=SDK%20downloads)](https://www.npmjs.com/package/@trigger.dev/sdk) -[![GitHub stars](https://img.shields.io/github/stars/triggerdotdev/trigger.dev?style=social)](https://github.com/triggerdotdev/trigger.dev) [![Twitter Follow](https://img.shields.io/twitter/follow/triggerdotdev?style=social)](https://twitter.com/triggerdotdev) [![Discord](https://img.shields.io/discord/1066956501299777596?logo=discord&logoColor=white&color=7289da)](https://discord.gg/nkqV9xBYWy) +[![GitHub stars](https://img.shields.io/github/stars/triggerdotdev/trigger.dev?style=social)](https://github.com/triggerdotdev/trigger.dev) @@ -24,9 +24,9 @@ Trigger.dev is the open-source platform for building AI workflows in TypeScript. Long-running tasks with retries, queues, observability, and elastic scaling. -## The perfect platform for building AI agents +## The platform designed for building AI agents -Build AI agents in familiar programming models using all the services and LLMs you already use, deploy them to Trigger.dev and get durable, long-running tasks with retries, queues, observability, and elastic scaling out of the box. +Build [AI agents](https://trigger.dev/product/ai-agents) using all the frameworks, services and LLMs you're used to, deploy them to Trigger.dev and get durable, long-running tasks with retries, queues, observability, and elastic scaling out of the box. - **Long-running without timeouts**: Execute your tasks with absolutely no timeouts, unlike AWS Lambda, Vercel, and other serverless platforms. @@ -42,10 +42,11 @@ Build AI agents in familiar programming models using all the services and LLMs y ## Key features: -- **[Write tasks in regular code](https://trigger.dev/docs/guides/introduction)** - Build background tasks using familiar programming models in native Javascript / Typescript and Python +- **[JavaScript and TypeScript SDK](https://trigger.dev/docs/tasks/overview)** - Build background tasks using familiar programming models - **[Long-running tasks](https://trigger.dev/docs/runs/max-duration)** - Handle resource-heavy tasks without timeouts - **[Durable cron schedules](https://trigger.dev/product/scheduled-tasks)** - Create and attach recurring schedules of up to a year - **[Trigger.dev Realtime](https://trigger.dev/product/realtime)** - Real-time bridge between your background tasks and frontend applications with LLM streaming support +- **[Build extensions](https://trigger.dev/docs/config/extensions/overview#build-extensions)** - Hook directly into the build system and customize the build process. Run Python scripts, FFmpeg, browsers, and more. - **[React hooks](https://trigger.dev/docs/frontend/react-hooks#react-hooks)** - Interact with the Trigger.dev API on your frontend using our React hooks package - **[Batch triggering](https://trigger.dev/docs/triggering#tasks-batchtrigger)** - Use batchTrigger() to initiate multiple runs of a task with custom payloads and options - **[Structured inputs / outputs](https://trigger.dev/docs/tasks/schemaTask#schematask)** - Define precise data schemas for your tasks with runtime payload validation @@ -56,7 +57,6 @@ Build AI agents in familiar programming models using all the services and LLMs y - **[Multiple environments](https://trigger.dev/docs/how-it-works#dev-mode)** - Support for DEV, PREVIEW, STAGING, and PROD environments - **[No infrastructure to manage](https://trigger.dev/docs/how-it-works#trigger-dev-architecture)** - Auto-scaling infrastructure that eliminates timeouts and server management - **[Automatic retries](https://trigger.dev/docs/errors-retrying)** - If your task encounters an uncaught error, we automatically attempt to run it again -- **[Build extensions](https://trigger.dev/docs/config/extensions/overview#build-extensions)** - Hook directly into the build system and customize the build process - **[Checkpointing](https://trigger.dev/docs/how-it-works#the-checkpoint-resume-system)** - Tasks are inherently durable, thanks to our checkpointing feature - **[Versioning](https://trigger.dev/docs/versioning)** - Atomic versioning allows you to deploy new versions without affecting running tasks - **[Machines](https://trigger.dev/docs/machines)** - Configure the number of vCPUs and GBs of RAM you want the task to use From c4c606939e3bbadc025fc7163bc0f39b8fbcae13 Mon Sep 17 00:00:00 2001 From: D-K-P <8297864+D-K-P@users.noreply.github.com> Date: Wed, 20 Aug 2025 16:58:55 +0100 Subject: [PATCH 12/15] Updated links --- README.md | 22 +++++++++++++--------- 1 file changed, 13 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 2c760f5c4f..db9cfb375f 100644 --- a/README.md +++ b/README.md @@ -44,16 +44,16 @@ Build [AI agents](https://trigger.dev/product/ai-agents) using all the framework - **[JavaScript and TypeScript SDK](https://trigger.dev/docs/tasks/overview)** - Build background tasks using familiar programming models - **[Long-running tasks](https://trigger.dev/docs/runs/max-duration)** - Handle resource-heavy tasks without timeouts -- **[Durable cron schedules](https://trigger.dev/product/scheduled-tasks)** - Create and attach recurring schedules of up to a year -- **[Trigger.dev Realtime](https://trigger.dev/product/realtime)** - Real-time bridge between your background tasks and frontend applications with LLM streaming support +- **[Durable cron schedules](https://trigger.dev/docs/tasks/scheduled#scheduled-tasks-cron)** - Create and attach recurring schedules of up to a year +- **[Trigger.dev Realtime](https://trigger.dev/docs/realtime/overview)** - Trigger, subscribe to, and get real-time updates for runs, with LLM streaming support - **[Build extensions](https://trigger.dev/docs/config/extensions/overview#build-extensions)** - Hook directly into the build system and customize the build process. Run Python scripts, FFmpeg, browsers, and more. - **[React hooks](https://trigger.dev/docs/frontend/react-hooks#react-hooks)** - Interact with the Trigger.dev API on your frontend using our React hooks package - **[Batch triggering](https://trigger.dev/docs/triggering#tasks-batchtrigger)** - Use batchTrigger() to initiate multiple runs of a task with custom payloads and options - **[Structured inputs / outputs](https://trigger.dev/docs/tasks/schemaTask#schematask)** - Define precise data schemas for your tasks with runtime payload validation - **[Waits](https://trigger.dev/docs/wait)** - Add waits to your tasks to pause execution for a specified duration - **[Preview branches](https://trigger.dev/docs/deployment/preview-branches)** - Create isolated environments for testing and development. Integrates with Vercel and git workflows -- **[Waitpoints](https://trigger.dev/docs/upgrade-to-v4#wait-tokens)** - Add human-in-the-loop judgment at critical decision points without disrupting workflow -- **[Concurrency & queues](https://trigger.dev/product/concurrency-and-queues)** - Set concurrency rules to manage how multiple tasks execute +- **[Waitpoints](https://trigger.dev/docs/wait-for-token#wait-for-token)** - Add human-in-the-loop judgment at critical decision points without disrupting workflow +- **[Concurrency & queues](https://trigger.dev/docs/queue-concurrency#concurrency-and-queues)** - Set concurrency rules to manage how multiple tasks execute - **[Multiple environments](https://trigger.dev/docs/how-it-works#dev-mode)** - Support for DEV, PREVIEW, STAGING, and PROD environments - **[No infrastructure to manage](https://trigger.dev/docs/how-it-works#trigger-dev-architecture)** - Auto-scaling infrastructure that eliminates timeouts and server management - **[Automatic retries](https://trigger.dev/docs/errors-retrying)** - If your task encounters an uncaught error, we automatically attempt to run it again @@ -63,10 +63,9 @@ Build [AI agents](https://trigger.dev/product/ai-agents) using all the framework - **[Observability & monitoring](https://trigger.dev/product/observability-and-monitoring)** - Monitor every aspect of your tasks' performance with comprehensive logging and visualization tools - **[Logging & tracing](https://trigger.dev/docs/logging)** - Comprehensive logging and tracing for all your tasks - **[Tags](https://trigger.dev/docs/tags#tags)** - Attach up to five tags to each run as powerful identifiers -- **[Advanced run filters](/product/observability-and-monitoring#advanced-filters)** - Easily sort and find tasks based on status, environment, tags, and creation date - **[Run metadata](https://trigger.dev/docs/runs/metadata#run-metadata)** - Attach metadata to runs which updates as the run progresses and is available to use in your frontend for live updates - **[Bulk actions](https://trigger.dev/docs/bulk-actions)** - Perform actions on multiple runs simultaneously, including replaying and cancelling -- **[Real-time alerts](https://trigger.dev/product/observability-and-monitoring#alerts)** - Choose your preferred notification method for run failures and deployments +- **[Real-time alerts](https://trigger.dev/docs/troubleshooting-alerts#alerts)** - Choose your preferred notification method for run failures and deployments ## Write tasks in your codebase @@ -99,7 +98,7 @@ We support `Development`, `Staging`, `Preview`, and `Production` environments, a View every task in every run so you can tell exactly what happened. We provide a full trace view of every task run so you can see what happened at every step. -![Trace view image](https://imagedelivery.net/3TbraffuDZ4aEf8KWOmI_w/7c1b347f-004c-4482-38a7-3f6fa9c00d00/public) +![Trace view image](https://content.trigger.dev/trace-view.png) # Getting started @@ -113,9 +112,14 @@ The quickest way to get started is to create an account and project in our [web ## Self-hosting -If you prefer to self-host Trigger.dev, you can follow our [self-hosting guide](https://trigger.dev/docs/v3/open-source-self-hosting#overview). +If you prefer to self-host Trigger.dev, you can follow our [self-hosting guides](https://trigger.dev/docs/self-hosting/overview): -We also have a dedicated self-hosting channel in our [Discord server](https://trigger.dev/discord) for support. +- [Docker self-hosting guide](https://trigger.dev/docs/self-hosting/docker) - use Docker Compose to spin up a Trigger.dev instance +- [Kubernetes self-hosting guide](https://trigger.dev/docs/self-hosting/kubernetes) - use our official Helm chart to deploy Trigger.dev to your Kubernetes cluster + +## Support and community + +We have a large active community in our official [Discord server](https://trigger.dev/discord) for support, including a dedicated channel for self-hosting. ## Development From e147eb452275e96dde662f4392ebd5e2eeef93da Mon Sep 17 00:00:00 2001 From: Matt Aitken Date: Wed, 20 Aug 2025 17:40:13 +0100 Subject: [PATCH 13/15] Minor readme tweaks --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index db9cfb375f..ba2bba06fd 100644 --- a/README.md +++ b/README.md @@ -38,7 +38,7 @@ Build [AI agents](https://trigger.dev/product/ai-agents) using all the framework - **Realtime apps & streaming**: Move your background jobs to the foreground by subscribing to runs or streaming AI responses to your app. -- **Observability & monitoring**: Each run has full tracing and logs. Configure error alerts to catch bugs fast. Monitor performance with metrics. +- **Observability & monitoring**: Each run has full tracing and logs. Configure error alerts to catch bugs fast. ## Key features: @@ -62,7 +62,7 @@ Build [AI agents](https://trigger.dev/product/ai-agents) using all the framework - **[Machines](https://trigger.dev/docs/machines)** - Configure the number of vCPUs and GBs of RAM you want the task to use - **[Observability & monitoring](https://trigger.dev/product/observability-and-monitoring)** - Monitor every aspect of your tasks' performance with comprehensive logging and visualization tools - **[Logging & tracing](https://trigger.dev/docs/logging)** - Comprehensive logging and tracing for all your tasks -- **[Tags](https://trigger.dev/docs/tags#tags)** - Attach up to five tags to each run as powerful identifiers +- **[Tags](https://trigger.dev/docs/tags#tags)** - Attach up to ten tags to each run, allowing you to filter via the dashboard, realtime, and the SDK - **[Run metadata](https://trigger.dev/docs/runs/metadata#run-metadata)** - Attach metadata to runs which updates as the run progresses and is available to use in your frontend for live updates - **[Bulk actions](https://trigger.dev/docs/bulk-actions)** - Perform actions on multiple runs simultaneously, including replaying and cancelling - **[Real-time alerts](https://trigger.dev/docs/troubleshooting-alerts#alerts)** - Choose your preferred notification method for run failures and deployments From e9a76d9a6f094da2220c942acb5b48702dc1510d Mon Sep 17 00:00:00 2001 From: D-K-P <8297864+D-K-P@users.noreply.github.com> Date: Thu, 21 Aug 2025 11:11:58 +0100 Subject: [PATCH 14/15] Updated banner --- README.md | 9 +++------ 1 file changed, 3 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index ba2bba06fd..b0bdff480b 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,7 @@
- - - - Trigger.dev logo - - + +![Trigger.dev logo](https://content.trigger.dev/github-header-banner.jpg) + ### Build and deploy fully‑managed AI agents and workflows [Website](https://trigger.dev) | [Docs](https://trigger.dev/docs) | [Issues](https://github.com/triggerdotdev/trigger.dev/issues) | [Feature requests](https://triggerdev.featurebase.app/) | [Public roadmap](https://triggerdev.featurebase.app/roadmap) | [Self-hosting](https://trigger.dev/docs/self-hosting/overview) From 99b7e5d48d107e04416476a0601919500c720738 Mon Sep 17 00:00:00 2001 From: D-K-P <8297864+D-K-P@users.noreply.github.com> Date: Thu, 21 Aug 2025 12:19:18 +0100 Subject: [PATCH 15/15] removed /v3/ --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index b0bdff480b..22181725bc 100644 --- a/README.md +++ b/README.md @@ -104,7 +104,7 @@ The quickest way to get started is to create an account and project in our [web ### Useful links: - [Quick start](https://trigger.dev/docs/quick-start) - get up and running in minutes -- [How it works](https://trigger.dev/docs/v3/how-it-works) - understand how Trigger.dev works under the hood +- [How it works](https://trigger.dev/docs/how-it-works) - understand how Trigger.dev works under the hood - [Guides and examples](https://trigger.dev/docs/guides/introduction) - walk-through guides and code examples for popular frameworks and use cases ## Self-hosting