How Weev works

Weev connects to your system in three simple layers.

Register your workflow

Register jobs directly in your service using the SDK. Declare dependencies so jobs run in the correct order.

Push your workflow

The CLI builds a workflow manifest from your service and pushes it to Weev as a versioned deployment.

Run and observe

Trigger runs, track status, see failures and active work. Your team gets a single operational view.

1

Register your jobs

You register jobs directly in your service using the Weev SDK. Each job belongs to a batch, and batches become the workflows Weev manages.

  • Jobs registered directly in your service
  • Group jobs into batches for workflow structure
  • Declare predecessors for dependency ordering
import { weev } from "@weev/sdk";

weev.job(
  {
    name: "generateInvoices",
    batch: "monthlyBillingRun",
    description: "Generate invoices for the current billing cycle",
    predecessors: ["loadActiveSubscriptions"]
  },
  async (ctx) => {
    ctx.log("info", "Generating invoices");
    return { ok: true };
  }
);
$weev generate

Scanning project for job definitions...

Found 3 jobs in 1 batch

Manifest written to .weev/manifest.json

$weev push

Uploading manifest...

Deployment created (v3)

Ready to orchestrate.

2

Push your workflow to Weev

The Weev CLI finds your job definitions and builds a workflow manifest. That manifest is pushed to Weev so your platform knows what jobs exist, how they are grouped, and how they depend on one another.

  • Automatic discovery of job definitions
  • Versioned deployments you can track and roll back
  • Workflow structure becomes a deployable orchestration model
3

Run and observe

Once deployed, Weev triggers workflow runs and executes jobs through your service. Instead of guessing what your job system is doing, your team can see it.

  • Trigger and track workflow runs
  • See failures, queue depth, and active work
  • A single operational view for your team
loadActiveSubscriptions
Success • 3m ago
generateInvoices
Running...
sendNotifications
Waiting

Why teams choose Weev

Workflow-aware, not config-heavy

Your workflows stay aligned with the systems they govern. That means less drift, fewer hidden systems, and a clearer path from product change to operational change.

Workflow deployments with intent

Background workflows change over time. Weev treats those changes as something to version and deploy, not something that silently mutates in production.

Better operational visibility

Runs, failures, active jobs, and workflow state all become visible in one place. Your team spends less time piecing together logs and more time fixing real issues.

Less custom infrastructure

You should not have to build your own orchestration platform just to run dependent jobs safely. Weev gives you the structure without forcing you to move your logic out of your app.

Quickstart

Getting started is straightforward.

1

Add the SDK

pnpm add @weev/sdk
2

Register your jobs

Register jobs with weev.job(...) in your service. Give each job a name, assign it to a batch, and add predecessors for dependency ordering.

3

Expose the execution endpoint

import express from "express";
import { createWeevMiddleware } from "@weev/sdk/express";

const app = express();
app.use(createWeevMiddleware());
app.listen(4100);
4

Initialize, generate, and push

$
weev init# Set up local config
$
weev login# Authenticate
$
weev link# Link to org, project, environment
$
weev generate# Scan code and build manifest
$
weev push# Deploy to Weev

At that point, Weev is ready to orchestrate your jobs.

What you get

  • Jobs captured in a clear workflow model
  • Workflow structure captured automatically
  • Deployable orchestration state
  • A platform for runs, failures, and workflow state
  • Clear operational ownership

Weev helps teams move from “a pile of background scripts” to a real workflow system.

Built for teams like yours

Weev is a strong fit if your team is dealing with:

×Brittle cron jobs
×Queue chains that are hard to reason about
×Workflow changes that are risky to deploy
×Poor visibility into job failures
×Too much custom operational glue

If that sounds familiar, Weev gives you a cleaner foundation.

Ready to bring structure to your background work?

Start with 5 jobs free. No credit card required.