Skip to main content
Triggers determine when Pullfrog runs.

​
Built-in triggers

Each trigger can be enabled or disabled, and you can add custom instructions to guide the agent’s behavior.
The simplest way to trigger Pullfrog. Just mention @pullfrog in any issue or PR comment, and Pullfrog will respond to your request.
Trigger when a collaborator opens a new issue. Useful for automatically creating implementation plans or responding to common questions.
Trigger when a non-collaborator opens an issue (only available for public repositories). Great for handling community questions or bug reports.
Trigger when an issue receives a specific label. You can configure which labels trigger the workflow.
Trigger when a collaborator opens a new PR. Useful for automatically reviewing PRs or suggesting improvements.
Trigger when a non-collaborator opens a PR. Great for reviewing community contributions.
Pullfrog will attempt to fix CI failures automatically. This only attempts once, and only when CI is passing on the PR’s target branch.
When someone reviews a PR created by Pullfrog, this trigger automatically addresses the feedback and updates the PR.
When CI fails on a PR created by Pullfrog, this trigger will attempt to fix the issues automatically.

​
Custom instructions

Each trigger can have custom instructions that can both:
  • Bias the agent towards a particular mode — e.g., “Use Review mode” or “Always create a plan first”
  • Provide additional context for that trigger — e.g., “Focus on test coverage” or “Link related issues in PR descriptions”
To add custom instructions, click the Add instructions button that appears to the right of any enabled trigger. Custom instructions in the Pullfrog dashboard