Skip to main content
Modes are specialized workflows that guide how Pullfrog handles different types of tasks. When Pullfrog receives a prompt, it analyzes the request and automatically selects the most appropriate mode.

​
How mode selection works

Mode selection happens automatically at the start of each agent run:
  1. Pullfrog reads all configured modes (built-in + custom)
  2. The agent analyzes the prompt against each mode’s description
  3. The best-matching mode is selected
  4. The mode’s prompt is injected to guide the agent’s behavior
You don’t need to specify which mode to use—Pullfrog figures it out from context. For example, a comment like “Please review this PR” will automatically trigger Review mode, while “Add dark mode support” will trigger Build mode.

​
Built-in modes

Pullfrog comes with five built-in modes:

Build

Implement, build, create, or develop code changes. Make specific changes to files or features. Execute a plan.Creates a branch, makes code changes, runs tests, and opens a PR.

Address Reviews

Address PR review feedback. Respond to reviewer comments. Make requested changes to an existing PR.Checks out the PR branch, addresses each review comment, replies to threads, and pushes updates.

Review

Review code, PRs, or implementations. Provide feedback or suggestions. Check code quality, style, and correctness.Analyzes the PR diff and submits a review with inline comments.

Plan

Create plans, break down tasks, outline steps. Analyze requirements and understand scope of work.Creates a structured plan with clear milestones and dependencies.

Prompt

Fallback for tasks that don’t fit other workflows. Direct prompts via comments, or requests requiring general assistance.This is the default mode for general-purpose tasks. If the task involves code changes, it follows the Build workflow.

​
Custom modes

Custom modes let you specialize Pullfrog’s behavior for your team’s specific workflows. They work exactly like built-in modes but are tailored to your needs. To create a custom mode:
  1. Navigate to your repository in the Pullfrog dashboard
  2. Go to the Modes section
  3. Click Add mode
  4. Fill in:
    • Name — A short name for the mode (e.g., “Refactor”)
    • Description — When to use this mode—this is what the agent matches against
    • Prompt — Instructions for the agent when this mode is selected
Custom modes in the Pullfrog dashboard