Pullfrog:GitHub Actions 上で動く AI エージェント

·Toolin 編集部

Zod の作者が発表したオープンソースの AI コーディングエージェント。GitHub Actions 上で完全に動作し、BYOK モードで LLM を自由に切り替え可能。コードレビューから CI 修復まで対応します。

Pullfrog:GitHub Actions 上で動く AI エージェント

Pullfrog は、Zod の作者である Colin McDonnell が開発したオープンソースの AI 駆動 GitHub bot です。GitHub Actions の内部で完全に動作し、ホステッド型のサードパーティサービスに一切依存しません。自分でコントロールでき、モデルに依存しないコードレビューと CI 自動修復のツールが必要なら、Pullfrog は注目に値します。

Pullfrog とは

簡単に言えば、Pullfrog はあなた自身の GitHub Actions 環境で動く AI エージェントです。リポジトリの webhook イベント(新しい PR、Issue、CI の失敗、Review の提出など)を監視し、AI エージェントによるタスク実行を自動的にトリガーします。

CodeRabbit のようなホステッド型 SaaS とは異なり、Pullfrog の核心的な特徴は次のとおりです。

  • オープンソースで無料:コードは完全に公開されており、自分で改変できる
  • モデル非依存:Anthropic、OpenAI、Google、Mistral、DeepSeek、OpenRouter などをサポートし、いつでも切り替え可能
  • データはリポジトリの外に出ない:すべての API キーは GitHub Secrets で管理され、エージェントはリポジトリ自身の Actions 環境で実行される

主な機能

Pullfrog の能力の守備範囲は、通常のコードレビューツールよりも広くなっています。

  • PR レビュー:プルリクエストを自動的にレビューし、改善提案を行う
  • Issue の仕分け:Issue の内容を自動分析し、分類・ラベル付け・担当者アサインを行う
  • CI 自動修復:CI ビルドが失敗した際、ログを自動で読み込み、問題を特定して修正をコミットする
  • マージコンフリクトの解決:コンフリクトを検出したら自動で解決を試みる
  • プラン生成:大きなタスクの実行計画を自動で分解する

専用に構築された MCP Server を同梱しており、git および GitHub 操作(PR の作成、レビューの投稿、CI ログの読み取り、Issue の管理)を実行します。Shell コマンドは隔離されたサブプロセスで動作し、機密性の高い環境変数にはアクセスできません。さらにヘッドレスブラウザツールも内蔵しており、エージェントはエンドツーエンドテストの実行、スクリーンショットの撮影、UI の反復改善が可能です。

クイックスタート

インストール

  1. Pullfrog GitHub App をインストールする(Pullfrog 公式サイトで申し込む)
  2. リポジトリに pullfrog.yml ワークフローファイルを追加する

使い方

2つのトリガー方法があります。

  • 手動トリガー:任意の Issue、PR、コメントで @pullfrog をメンションして、エージェントの実行を1回トリガーする
  • 自動トリガー:Pullfrog コンソールで自動化トリガールールを設定する(新しい PR の自動レビュー、CI 失敗時の自動修復など)

設定例

リポジトリのルートに .github/workflows/pullfrog.yml を作成します。

name: Pullfrog
on:
  issues:
    types: [opened, labeled]
  pull_request:
    types: [opened, synchronize]
  issue_comment:
    types: [created]
  pull_request_review:
    types: [submitted]

jobs:
  pullfrog:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run Pullfrog
        uses: pullfrog/action@main
        with:
          api-key: ${{ secrets.PULLFROG_API_KEY }}
          llm-provider: anthropic  # openai、google などに切り替え可能
          llm-model: claude-sonnet-4-20250514

競合との違い

機能PullfrogCodeRabbitGitHub Copilot Review
オープンソースはいいいえいいえ
モデル選択自由に切り替え固定固定
実行環境あなたの GitHub ActionsホステッドサービスGitHub ネイティブ
コードレビュー対応対応対応
CI 修復対応非対応非対応
Issue の仕分け対応非対応非対応
費用LLM API 利用料のみサブスクリプション制サブスクリプション制

適したシーン

  • 個人プロジェクト/小規模チーム:コードレビューのために追加の費用を支払いたくない場合、手持ちの LLM API キーを使うだけでよい
  • コードのセキュリティが重要な場合:コードとデータがあなたの GitHub 環境の外に出ない
  • より細かいコントロールが必要な場合:レビュールールのカスタマイズ、モデルの選択、エージェントの挙動調整をしたい

注意点

  • Pullfrog は現在 Beta 段階にあり、機能はまだ急ピッチで更新中
  • 主に CI/CD シーンの自動化向けであり、ローカル開発エージェントとしての使用には向かない(ローカルエージェントが必要なら、Claude Code か OpenCode をそのまま使えばよい)
  • プロジェクトのソースコードはすでに 400 個以上の star を獲得しており、コミュニティもまずまず活発

プロジェクトURL:github.com/pullfrog/pullfrog