Skip to main content
Get Pullfrog up and running in your repository in just a few minutes.

​
Sign into Pullfrog console with GitHub

Navigate to the Pullfrog console and sign in with your GitHub account. This will authenticate you and allow Pullfrog to access your repositories.
Sign in to Pullfrog console with GitHub

​
Install the Pullfrog app

Install the Pullfrog GitHub App on a GitHub account. During installation, you can choose to limit access to specific repositories or grant access to all repositories. You can install the Pullfrog GitHub App on your personal account:
Install Pullfrog GitHub App on personal account
Or on an organization you control:
Install Pullfrog GitHub App on organization
After installation, you’ll be redirected to the Pullfrog dashboard.

​
Select a repository

Select a repository you’d like to configure. While GitHub Apps are installed at the account level, all Pullfrog configuration is at the repo level — each repository has its own settings for triggers, modes, and agents.
Select a repository to configure

​
Add the pullfrog.yml workflow

You’ll be prompted to create the .github/workflows/pullfrog.yml file in your repository. Pullfrog uses this workflow to programmatically trigger agent runs on your repo. You can add it with one click from the dashboard.
Add pullfrog.yml workflow file with one click

​
Manual workflow setup

If you prefer to add the workflow manually, create .github/workflows/pullfrog.yml with the following content: 
name: Pullfrog
run-name: ${{ inputs.name || github.workflow }}
on:
  workflow_dispatch:
    inputs:
      prompt:
        type: string
        description: Agent prompt
      name:
        type: string
        description: Run name

permissions:
  id-token: write
  contents: write
  pull-requests: write
  issues: write
  actions: read
  checks: read

jobs:
  pullfrog:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - name: Run agent
        uses: pullfrog/pullfrog@v0
        with:
          prompt: ${{ inputs.prompt }}
        env:
          # add API keys for your LLM provider(s)
          # comment out any you won't use
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
          GOOGLE_API_KEY: ${{ secrets.GOOGLE_API_KEY }}
          GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
          MISTRAL_API_KEY: ${{ secrets.MISTRAL_API_KEY }}
          GROQ_API_KEY: ${{ secrets.GROQ_API_KEY }}
          DEEPSEEK_API_KEY: ${{ secrets.DEEPSEEK_API_KEY }}
          OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}

​
Add API keys

Navigate to your repository settings on GitHub and add API keys for your preferred LLM provider(s) as secrets:
  1. Navigate to github.com/your_org/your_repo/settings/secrets/actions
  2. Click New repository secret
  3. Add secrets for your preferred provider(s):
    • ANTHROPIC_API_KEY (for Claude models)
    • OPENAI_API_KEY (for OpenAI models)
    • GOOGLE_API_KEY or GEMINI_API_KEY (for Google models)
    • MISTRAL_API_KEY (for Mistral models)
    • GROQ_API_KEY (for Groq models)
    • DEEPSEEK_API_KEY (for DeepSeek models)
    • OPENROUTER_API_KEY (for OpenRouter — access multiple providers with a single key)
You only need to add secrets for the providers you plan to use. Comment out the unused keys in your workflow file. For free model options, org-level secrets, and troubleshooting, see Keys.

​
Test your installation

Once the workflow is installed and your API keys are configured, you can test Pullfrog using the prompt box in the dashboard:
  1. Navigate to your repository in the Pullfrog dashboard
  2. Enter a prompt in the text box (e.g., “Tell me a joke”)
  3. Click the Send button, or press Cmd+Enter (Mac) or Ctrl+Enter (Windows/Linux)
Test Pullfrog installation
This will dispatch a new GitHub Actions run and automatically open the run logs in a new tab. Monitor the logs to ensure the agent works as expected.

​
Next steps