Scheduled Workflows

Workflows can run automatically on a schedule. Add a trigger to your workflow YAML and 8Vast runs it in the background.

Example: automated code review

name: review
description: Review code and suggest improvements

trigger:
  schedule: 30m

run_with:
  model: claude-sonnet-4-6

instructions: |
  Review recently changed files.
  Look for bugs, anti-patterns, and missing tests.
  Write your findings to docs/review-notes.md.

The schedule field accepts intervals: 30s, 5m, 1h, 2h30m.

How it works

When 8Vast's background service sees a workflow with trigger.schedule, it runs it automatically at that interval. The workflow uses the same AI, same tools, same model as when you run it manually.

Inputs for scheduled workflows

If your workflow has inputs, set default values in the trigger:

inputs:
  scope:
    type: string
    required: true

trigger:
  schedule: 1h
  inputs:
    scope: src/

Check what's running

8v status

Shows active workflows, scheduled tasks, and background activity.

Workflows — Write and run workflows
Pre-commit Hooks — Lint before every commit

Referenced by

Custom Tools