Automations
Run the agent automatically on schedules, GitHub events, Slack messages, or manual triggers.
Automations let you configure the agent to run automatically in response to events or on a schedule. Each automation has a prompt, target repositories, and one or more triggers.
Creating an Automation
- Go to Agent > Automations in the dashboard
- Click New Automation
- Configure the automation:
- Name — A descriptive name for the automation
- Prompt — The instruction the agent will execute
- Repositories — Which repos the automation targets
- Model — Agent model tier (Max, Mid, Fast)
- Triggers — When the automation should run
- Environment variables — Optional env vars for the session
- Tools — Memory, MCP integrations, and custom commands available to the agent
Triggers
Schedule Triggers
Run the agent on a recurring schedule:
- Daily — Runs at a specific time each day
- Weekly — Runs on selected days at a specific time
- Cron — Custom cron expressions for advanced scheduling
All schedules support timezone configuration.
GitHub Event Triggers
Run the agent in response to GitHub activity:
| Trigger | Description |
|---|---|
| PR Created | A new pull request is opened |
| PR Merged | A pull request is merged |
| Push | Code is pushed to a branch |
| Comment Created | A comment is posted on a PR or issue |
| Review Submitted | A code review is submitted (approved, changes requested, or commented) |
Filters
Narrow down when triggers fire:
- Branch patterns — Only trigger on branches matching a pattern (e.g.,
feature/*) - Label filters — Only trigger on PRs with specific labels
Slack Triggers
Run the agent when a message is posted in a Slack channel:
- Channel filter — Only trigger on messages in a specific channel
- Thread-only — Only trigger on threaded messages
- Text includes — Only trigger when the message contains specific text
Manual Triggers
Click Run on any automation to trigger it immediately. This creates an agent session with the automation's prompt and settings.
Templates
Paragon provides preset automation templates for common workflows:
| Template | Description |
|---|---|
| Find Vulnerabilities | Scan for security vulnerabilities |
| Assign PR Reviewers | Auto-assign reviewers to new PRs |
| Summarize Changes Daily | Daily summary of all code changes |
| Fix Bugs Reported in Slack | Respond to bug reports in Slack |
| Add Test Coverage | Generate tests for untested code |
| Clean Up Feature Flags | Remove stale feature flags |
| Find Critical Bugs | Deep scan for critical bugs |
| Fix CI Failures | Investigate and fix failing CI pipelines |
| Generate Docs | Auto-generate documentation for new code |
| Investigate PagerDuty Incidents | Triage PagerDuty alerts |
| Investigate Datadog Errors | Analyze Datadog error reports |
| Triage Linear Issues | Auto-triage incoming Linear issues |
Browse templates when creating a new automation to get started quickly.
Slack Reporting
Configure Slack notifications for automation runs:
- Enable reporting — Toggle Slack notifications on/off
- Channel — Select which Slack channel receives reports
- Include output — Optionally include the full agent output in the message
Viewing Runs
Go to Agent > Automations > Runs to see all automation runs with:
- Status — Pending, running, success, or failed
- Trigger type — What triggered the run (scheduled, manual, PR event, Slack, etc.)
- Automation name — Which automation was executed
- Session link — Link to the agent session for full details
- Error messages — Inline error display for failed runs
- Filters — Filter by scope (mine/all), status, trigger type, automation name, or date range
Automation States
| Status | Description |
|---|---|
| Active | Running on triggers and schedules |
| Paused | Triggers ignored until resumed |
| Archived | Disabled and hidden from active list |
Examples
Nightly QA review:
Review all changes pushed today. Flag security vulnerabilities, missing tests, performance regressions, and potential bugs. Open a PR with fixes.
Trigger: Daily at 9:00 AM
Auto-fix on review:
Address the requested changes in this review. Follow the reviewer's feedback exactly.
Trigger: Review submitted with "changes requested"
Test generation on new PRs:
Generate unit tests for all new or modified functions in this PR. Ensure edge cases and error paths are covered.
Trigger: PR created
Fix bugs from Slack:
Investigate the bug described in this Slack message. Reproduce it, find the root cause, and open a PR with a fix.
Trigger: Slack message in #bugs channel