Skip to main content

GitHub App

The GitHub App lets you trigger Nimbus directly from pull requests and issues using /nimbus commands.

Create the GitHub App​

  1. Go to github.com/settings/apps/new (or your organization's Apps settings)
  2. Set the App name to something recognizable (e.g., nimbus-bot)
  3. Set the Homepage URL to https://get-nimbus.com
  4. Set the Webhook URL to https://api.get-nimbus.com/github/webhook
  5. Set a Webhook secret — save this for your .env

Permissions​

Under Repository permissions:

PermissionAccess
ContentsRead & write
IssuesRead & write
Pull requestsRead & write
MetadataRead-only

Subscribe to events​

Check all of the following:

  • Issues
  • Issue comment
  • Pull request
  • Pull request review
  • Pull request review comment
  • Reactions
  1. Click Create GitHub App
  2. Generate a private key and download the .pem file
  3. Note the App ID from the app settings page

Install on repositories​

From the app settings page, click Install App and select the repositories you want Nimbus to have access to.

Using /nimbus in PRs and issues​

Once installed, you can trigger Nimbus from any comment:

/nimbus add input validation to the registration endpoint

Nimbus will react with 👀 to acknowledge, then post progress updates as comments.

When complete, it posts the PR URL (or a link to the changes in the current PR) and a self-review.

The nimbus label​

Apply the nimbus label to any issue to have Nimbus automatically pick it up and create a PR. This works without any comment — just label the issue.

# On any issue with the "nimbus" label attached:
→ Nimbus reads the issue title and body as the task description
→ Creates a branch, implements the changes, opens a PR
→ Posts a comment on the issue with the PR URL

Self-review​

Every PR opened by Nimbus includes an automated self-review comment. The review uses Claude Sonnet to analyze the diff and posts a structured critique:

  • What was changed and why
  • Potential edge cases not covered
  • Suggested follow-up tasks

This appears as a PR review (not just a comment) so it shows up in GitHub's review UI.