Skip to main content

Quickstart

What you will build

You will install a GitHub pull request reviewer fleet. The fleet will receive pull request events and post review comments.

Before you begin

You need Node.js 24 or later. You also need an agentsfleet account and a GitHub repository that you can manage. Create a GitHub token that can read the repository and post comments. Keep the token ready for step 4.

Steps

  1. Install the agentsfleet command-line interface.
  2. Check the installed version.
  3. Sign in through your browser.
    Approve the request in your browser. Enter the six-digit code in your terminal when prompted.
  4. Save the GitHub secret in your active workspace.
    GitHub gives you <GITHUB_TOKEN> after you create the repository token. Create <GITHUB_WEBHOOK_SECRET> as a random value with at least 32 characters. Enter the same value in GitHub during step 6. The client sends both values to your workspace vault. The client does not print the values again.
  5. Install the review fleet.
    Save the fleet identifier and webhook URL from this output. You will use both values below.
  6. Add the webhook in GitHub. Open Repository settings → Webhooks → Add webhook. Use the webhook URL from step 5 as the payload URL. Choose application/json as the content type. Use the same webhook secret from step 4. Select Pull requests as the event. GitHub now sends pull request events to your fleet.
  7. Open a pull request in the repository. GitHub sends the event after you open the pull request. The fleet then posts a review comment.

Verify it works

<FLEET_ID> comes from the install output in step 5.
The activity stream should show a GitHub event. Check the pull request for the fleet’s review comment.

What you learned

You installed the client, signed in, saved a secret, and created a fleet. You also connected GitHub to the fleet.