GitZoid Tutorial

GitZoid is your open-source, AI-powered pull request reviewer — designed to automate GitHub PR comments using models like GPT or Claude. With WaveAssist, you get instant deployment, zero infrastructure hassle, built-in scheduling, and secure secrets management.

Prerequisites

Before you begin, make sure you have:

• A GitHub GHP Token
• An API key from either OpenAI or Anthropic
• A free WaveAssist account

Step-by-Step Guide

1. Deploy GitZoid Template

1. Click the "Deploy Template" button above
2. Log in or create a free WaveAssist account if prompted
3. The GitZoid template project will be automatically created for you

2. Configure Secrets

In your new project:

1. Navigate to the Variables tab
2. Add the following secrets:
   • github_ghp_token: Your GitHub token
   • openai_key or anthropic_key: Your chosen AI model provider's API key

3. Initialize Repositories

1. Go to the Nodes tab
2. Find and run the InitializeRepositories node
3. Optionally edit the repositories variable to specify which GitHub repos GitZoid should monitor

4. Run PR Reviews

1. Locate and run the FetchPRs node
2. This will:
   • Fetch all open pull requests
   • Use AI to review them
   • Post structured review comments on your GitHub PRs

5. Deploy for Automation

1. Click the Deploy button to run GitZoid automatically
2. Set up your preferred schedule (e.g., every few hours or daily)

Optional Enhancements

Enable Real-Time Reviews

To get instant PR reviews via GitHub webhook:

1. Open the FetchPRs node
2. Copy the Webhook URL shown on the right
3. In your GitHub repo:
   • Go to Settings → Webhooks
   • Click "Add webhook"
   • Paste the webhook URL in "Payload URL"
   • Select "Let me select individual events"
   • Check "Pull requests"
   • Click "Create webhook"

Customize the AI Prompt

To fine-tune GitZoid's review style:

1. Go to the Nodes tab
2. Open the GenerateReviews node
3. Find the get_prompt function
4. Modify the prompt to match your preferences
5. Save and redeploy the node

Need Help?

If you run into any issues or need assistance, reach out to our team:

• You can schedule a call with our team using this link
• Email us at support@waveassist.io