TerragonTerragon Docs
Tasks

Automations

Create recurring tasks that run on a schedule or via manual trigger

Automations are saved prompts that run automatically in response to a trigger. We currently support two types of triggers:

  • Manual: these run on-demand when you explicitly trigger them
  • Schedule: these run automatically at a specified frequency. Either daily, weekly, monthly, weekdays only, or custom weekly (eg, Tuesdays and Wednesdays).

Examples

Tasks you run regularly, but not on a set schedule:

  • Standardized code reviews before merging PRs
  • Debugging and root cause analysis based on a bug report
  • Updating dependencies
  • Well defined migrations
  • Generating tests for new features
  • Updating documentation based on recent commits

Task you run regularly on a predictable schedule:

  • Writing release notes based on recent commits
  • Daily summaries of commits to a repo
  • Identifying and cleaning up dead code
  • Reviewing external tickets to decide which tasks to start next
  • Rebasing long-running branches onto the default branch
  • Identifying and addressing stale PRs

Creating an Automation

Navigate to Automations from the sidebar

Click Create Automation
Enter a name for your automation
Write your prompt as you normally would
Choose the trigger type
For scheduled automations, set the schedule frequency
Click Create to save your automation

Running Automations

Before creating an Automation that runs on a schedule, run it manually to ensure it works as expected.

Every time an Automation runs, it creates a task that shows up in your task list on the home page. That way, you can track progress and manage next steps just like with any other task.

To see all of the past runs and tasks created by an Automation, click on it from Automations. This is helpful for ensuring your Automations are completing as expected.