Skip to main content
This guide covers automation configuration in detail. For a quick walkthrough, see Create your first automation.

​
Create an automation

  1. Navigate to Automations in the left panel
  2. Click New Automation
  3. Choose Start from scratch or select a pre-configured template
Automations page

​
Basic settings

  • Name - Short, descriptive name (e.g., “Weekly dependency updates”)
  • Description - What the automation does
  • Run as - Your user (manual workflows) or a service account (scheduled/event-driven)
Basic configuration

​
Trigger type

​
Guardrails

Control execution limits to prevent automations from running excessively:
  • Max concurrent executions - Simultaneous runs (default: 10)
  • Max total executions - Total allowed (default: 100)
ScaleConcurrentTotal
Testing (1-10 repos)520
Team (10-50 repos)10100
Organization (50+ repos)20-50500+
See Guardrails for more controls.

​
Steps

Steps execute in sequence within the same environment. Each step can access files, environment variables, and context from previous steps.

​
Step types

TypeUse when
PromptFlexible tasks requiring agent judgment - “analyze and improve”, “update based on context”
Shell scriptDeterministic operations - npm test, docker build
Pull requestSubmit changes for review after making modifications

​
Example workflow

Step 1 (Prompt):    "Upgrade all dependencies to their latest versions"
Step 2 (Script):    npm test
Step 3 (PR):        Create pull request with summary
Guidance:
  • Use prompts for context-aware tasks that vary by repository
  • Use scripts for predictable, repeatable operations
  • Combine both: scripts for validation, prompts for intelligent changes
Steps configuration

​
Save and edit

Click Save to create the automation. You can edit any automation later - all settings can be modified after creation.
Webhook configuration for pull request triggers is available after saving. See Pull request triggers for details.

​
Next steps