Skip to main content
What is a Workflow?A Workflow automatically runs an Agent on a repository when:
  • A schedule is reached (cron)
  • An event occurs (webhook, e.g. GitHub PR)
Use Workflows for recurring or event-driven tasks like:
  • Daily vulnerability scans
  • Weekly changelog generation
  • Reacting to new pull requests or Sentry alerts

​
Creating a Workflow

1

Start from scratch or a template

In Mission Control → Workflows, create a new workflow.
Create a workflow from scratch by clicking Create Workflow.
You’ll choose the repository, agent, trigger type, and schedule or webhook.
Select any of the “Try these Workflows” cards such as:
  • Update agents.md
  • Draft Changelog Updates
  • Solve Snyk Vulnerabilities
Templates preload the recommended agent and schedule so you can customize and run them quickly.
2

Name the Workflow

Give your Workflow a clear, descriptive name.Examples:
  • Morning status check
  • Weekly changelog draft
  • Daily Snyk vulnerability scan
3

Select Repository & Agent

Choose:
  • Repository – the codebase the Agent will run against
  • Agent – the configured Agent (model, rules, tools, prompt) that should perform the work
Need a new Agent? Create one in Mission Control → Agents, then return to this screen.
4

Choose Trigger Type

Pick how this Workflow should run:
  • Cron – run on a schedule (daily, weekly, hourly, custom)
  • Webhook – run when an external system sends a request (e.g. GitHub PR event)
5

Configure the Trigger

For scheduled Workflows:
  1. Select Cron as the trigger type
  2. Choose a schedule:
    • Common presets (e.g. weekdays at 9 AM UTC)
    • Hourly, Daily, Weekly, Monthly
    • Or define a Custom expression
  3. (Optional) Add additional instructions for this Workflow run in the text area.
Example use cases:
  • Run a morning status check on your repo every weekday
  • Refactor React components once per week
  • Generate a weekly changelog from recent commits
For event-based Workflows:
  1. Select Webhook as the trigger type
  2. (Optional) Set a Secret Header (e.g. X-Webhook-Secret)
  3. (Optional) Set a Secret Value (token your external system must send)
You’ll receive a webhook URL to call from:
  • GitHub Actions
  • GitHub webhooks
  • CI/CD pipelines
  • Any external system that can send HTTP requests
Example use cases:
  • Run an Agent whenever a pull request is opened
  • Kick off a workflow when Snyk or Sentry detects an issue
6

Create the Workflow

Click Create Cron Workflow or Create Webhook Workflow, depending on your trigger type.Your Workflow will now appear in the Workflows list and begin running based on its configured schedule or events.

​
Monitoring Workflow Runs

Workflow runs show up just like Tasks:
  • Each execution creates a Session
  • Workflows appear in your Inbox
  • You can open the detail view to see the summary, diff, and logs.

Create a Workflow Now

Add an Integration

Connect GitHub, Slack, and Sentry for richer triggers and actions.