Skip to content
Cheffed

Automations

Automations let you trigger AI sessions based on events, enabling hands-off workflows that respond to your development process.

What is an Automation?

Section titled “What is an Automation?”

An automation consists of:

  • Trigger - An event that starts the automation (e.g., a new GitHub issue)
  • Action - What happens when triggered (e.g., start a session with a specific agent)
  • Configuration - Settings that customize behavior (e.g., which repos, labels, models)

When the trigger event occurs, Cheffed automatically starts a session with your configured agent and context.

How It Works

Section titled “How It Works”
Event (GitHub Issue) → Automation → Session Started → Agent Works → Results
  1. An event occurs (e.g., someone opens a GitHub issue with a specific label)
  2. Cheffed detects the event via your connected integrations
  3. The automation’s trigger conditions are evaluated
  4. If conditions match, a new session is created
  5. The agent receives context from the event and begins working
  6. Results can include code changes, PRs, comments, or reports

Common Use Cases

Section titled “Common Use Cases”

Automated Bug Triage

Section titled “Automated Bug Triage”

Trigger on new GitHub issues labeled bug. The agent analyzes the issue, searches the codebase for relevant code, and posts a comment with initial findings.

PR Code Review

Section titled “PR Code Review”

Trigger on new pull requests. The agent reviews the changes, checks for common issues, and provides feedback as PR comments.

Issue Implementation

Section titled “Issue Implementation”

Trigger on issues labeled automate. The agent reads the issue, implements the requested feature, and creates a pull request.

Documentation Updates

Section titled “Documentation Updates”

Trigger on merged PRs that touch specific files. The agent updates relevant documentation based on the code changes.

Trigger Types

Section titled “Trigger Types”

GitHub Issues

Section titled “GitHub Issues”

React to new issues or issue updates:

  • Filter by repository
  • Filter by labels (e.g., only bug or enhancement)
  • Access issue title, body, and metadata in the session

GitHub Pull Requests

Section titled “GitHub Pull Requests”

React to PR events:

  • New PRs opened
  • PR updates
  • Filter by base branch, labels, or files changed

Actions

Section titled “Actions”

Currently, automations support one action type:

Start Session

Section titled “Start Session”

Creates a new AI session with:

  • Agent/Prompt - Which agent template to use
  • Model - Which AI model powers the session
  • Context - Information passed from the trigger event
  • Repository - Optionally clone a repo into the session

Execution and Monitoring

Section titled “Execution and Monitoring”

Track your automations on the Automations page:

  • View all configured automations
  • See execution history
  • Monitor success/failure rates
  • Debug failed executions

Next Steps

Section titled “Next Steps”