# vercel/workflow

Workflow SDK: Build durable, reliable, and observable apps and AI Agents in TypeScript

Repository: https://github.com/vercel/workflow
Canonical: https://ross.abutalabs.com/products/vercel-workflow
Homepage: https://workflow-sdk.dev
Language: TypeScript
License: Apache-2.0
License Family: permissive
Topics: ai-agents, durable-execution, orchestration, vercel, serverless, workflow-engine, workflows
Last push: 2026-08-26T21:33:26+00:00

## Health v2 (maintenance only)
Score: 79/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 87, longevity 22
- inputs: {"age_days": 314, "days_push": 7, "days_rel": 8, "gap_med": 2.0, "n_releases_24m": 71}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2350, forks 345 (observed 2026-08-28T04:06:40.313803+00:00)

## What it is
Workflow SDK is a TypeScript library that makes async functions durable via 'use workflow' and 'use step' directives, providing suspend/resume, retries, and observability without hand-rolled queues. It integrates with Next.js, Vite, Astro, Express, Fastify, Hono, Nitro, Nuxt, SvelteKit, and TanStack Start, and is aimed at building reliable apps and AI agents.

## Use cases
- build durable background workflows in TypeScript
- run long-running AI agent tasks that can suspend and resume
- replace hand-rolled queues and retry logic with durable execution
- schedule delayed steps like sending a check-in email after 7 days without holding resources
- orchestrate multi-step API calls with automatic retries and observability
- add durable execution to a Next.js or Hono app

## When to choose
- you need durable, resumable async workflows in TypeScript
- you're building AI agents that must survive failures and pauses
- you want a lightweight directive-based alternative to Temporal or Inngest
- you use Next.js, Vite, Astro, Express, Fastify, Hono, Nitro, Nuxt, or SvelteKit

## When to avoid
- you need durable workflows in a language other than TypeScript or Python
- you're on a framework not supported by the SDK's integrations
- you need a mature, battle-tested workflow engine with years of production hardening
- your workflows are simple enough that plain async code suffices

## Facets
- artifact type: library
- maturity: active
- function: workflow-automation, agent-framework, sdk, middleware
- domain: developer-tools, web-development, backend
- platform: serverless, cross-platform
- tags: durable-execution, workflow-engine, ai-agents, orchestration, serverless, use-workflow-directive, temporal-alternative, automation, nodejs, typescript

## Member repositories
- vercel/workflow (main) score 79

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:40.313803+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:36:56.364105+00:00, confidence not recorded.
  - readme: https://github.com/vercel/workflow (fetched 2026-08-28T04:06:40.313803+00:00, sha b0ef03fb3faf)
  - homepage: https://workflow-sdk.dev (fetched 2026-08-29T10:17:48.995438+00:00, sha f30756e58ad7)
  - site_page: https://workflow-sdk.dev/docs (fetched 2026-08-29T10:17:48.998282+00:00, sha e11873fa27d3)
  - site_page: https://workflow-sdk.dev/docs/getting-started/next (fetched 2026-08-29T10:17:49.000451+00:00, sha 09640b27bb23)
  - site_page: https://workflow-sdk.dev/docs/getting-started/vite (fetched 2026-08-29T10:17:49.002743+00:00, sha 7e92b88cbdfb)
  - site_page: https://workflow-sdk.dev/docs/getting-started/astro (fetched 2026-08-29T10:17:49.005060+00:00, sha 80ad702cbc3b)
  - site_page: https://workflow-sdk.dev/docs/getting-started/express (fetched 2026-08-29T10:17:49.007844+00:00, sha 672caba3edac)
  - site_page: https://workflow-sdk.dev/docs/getting-started/fastify (fetched 2026-08-29T10:17:49.010334+00:00, sha 8701b6f53cfa)
  - site_page: https://workflow-sdk.dev/docs/getting-started/hono (fetched 2026-08-29T10:17:49.012340+00:00, sha 681e146b52ca)
  - site_page: https://workflow-sdk.dev/docs/getting-started/nitro (fetched 2026-08-29T10:17:49.014119+00:00, sha 5a8303bd6def)
- Data as of 2026-08-30T08:39:29.467469+00:00.
